title: Javadoc warning being shown while generating the package
body: <p>I'm working on the javadocs of a project, fixing all the errors and warnings that Javadoc shows.. But after fixing most of them, there are just this one that is being shown for some reason that I can't imagine.</p>
  
  <pre><code>4 warnings
  [WARNING] Javadoc Warnings
  [WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:100: warning - Tag @see: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
  [WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:140: warning - Tag @see: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
  [WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:166: warning - Tag @link: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
  [WARNING] C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\src\main\java\com\globalmentor\marmot\MarmotSession.java:140: warning - Tag @link: can't find getResourceKit(Repository, URFResource, Capability...) in com.globalmentor.marmot.MarmotSession
  [INFO] Building jar: C:\Users\magno\Documents\Globalmentor\Globalmentor's work\marmot\target\marmot-0.5.1-SNAPSHOT-javadoc.jar
  [INFO] ------------------------------------------------------------------------
  [INFO] BUILD SUCCESS
  [INFO] ------------------------------------------------------------------------
  [INFO] Total time: 33.921 s
  [INFO] Finished at: 2016-10-21T10:03:11-02:00
  [INFO] Final Memory: 29M/412M
  [INFO] ------------------------------------------------------------------------
  </code></pre>
  
  <p>The problem is: These references are on the same class than the method, and even Eclipse suggests them when I start writing the references, does anybody know anything else that could give me this warning?</p>
  
  <p>Here is the javadocs that shows the warning:</p>
  
  <pre><code>/**
   * Determines if there exists resource kit appropriate for the given resource supporting the given capabilities.
   * @param repository The repository in which the resource resides.
   * @param resource The resource for which a resource kit should be returned.
   * @param capabilities The capabilities required for the resource kit.
   * @return &lt;code&gt;true&lt;/code&gt; if there exists a resource kit to handle the given resource with the given capabilities, if any, in relation to the resource.
   * @see #getResourceKit(Repository, URFResource, Capability...)
   */
  public boolean hasResourceKit(final Repository repository, final URFResource resource, final Capability... capabilities);
  
  /**
   * Retrieves a resource kit appropriate for the given resource statically if possible, without further resource lookup. This method locates a resource kit in
   * the following priority:
   * &lt;p&gt;
   * The first resource kit supporting the resource content type determined by:
   * &lt;/p&gt;
   * &lt;ol&gt;
   * &lt;li&gt;The given content type, if any.&lt;/li&gt;
   * &lt;li&gt;The content determined if possible by {@link #getExtensionContentType(String)} from the resource URI extension.&lt;/li&gt;
   * &lt;li&gt;The resource description is retrieved as a last resort and the resource kit is determined by delegating to
   * {@link #getResourceKit(Repository, URFResource, Capability...)}.&lt;/li&gt;
   * &lt;/ol&gt;
   * @param repository The repository in which the resource resides.
   * @param resourceURI The URI of the resource in the given repository.
   * @param contentType The type of content the resource contains, or &lt;code&gt;null&lt;/code&gt; if unknown.
   * @param capabilities The capabilities required for the resource kit.
   * @return A resource kit to handle the given resource with the given capabilities, if any, in relation to the resource; or &lt;code&gt;null&lt;/code&gt; if there is no
   *         registered resource kit with the given capabilities in relation to the resource.
   * @throws ResourceIOException if an error occurred retrieving a description of the resource kit.
   * @see #getResourceKit(Repository, URFResource, Capability...)
   */
  public RK getResourceKit(final Repository repository, final URI resourceURI, final ContentType contentType, final Capability... capabilities)
          throws ResourceIOException;
  
  /**
   * Retrieves a resource kit appropriate for a MIME content type. This method should only be used for special-purpose functionality; when accessing resources
   * {@link #getResourceKit(Repository, URFResource, Capability...)} should normally be used instead.
   * @param contentType The type of content the resource contains.
   * @param capabilities The capabilities required for the resource kit.
   * @return A resource kit with the requested capabilities to handle the given content type, or &lt;code&gt;null&lt;/code&gt; if no appropriate resource kit is registered.
   */
  public RK getResourceKit(final ContentType contentType, final Capability... capabilities);
  </code></pre>
  
  <hr>
  
  <p>And here is the method that's being referenced in the javadocs above, it's from the same class:</p>
  
  <pre><code>/**
   * Retrieves a resource kit appropriate for the given resource. This method locates a resource kit in the following priority:
   * &lt;ol&gt;
   * &lt;li&gt;The first resource kit supporting the resource content type determined by {@link #determineContentType(URFResource)}.&lt;/li&gt;
   * &lt;li&gt;The first resource kit supporting one of the resource types.&lt;/li&gt;
   * &lt;li&gt;If the resource has a collection URI, the default collection resource kit.&lt;/li&gt;
   * &lt;li&gt;The default resource kit.&lt;/li&gt;
   * &lt;/ol&gt;
   * @param repository The repository in which the resource resides.
   * @param resource The resource for which a resource kit should be returned.
   * @param capabilities The capabilities required for the resource kit.
   * @return A resource kit to handle the given resource with the given capabilities, if any, in relation to the resource; or &lt;code&gt;null&lt;/code&gt; if there is no
   *         registered resource kit with the given capabilities in relation to the resource.
   * @see #determineContentType(URFResource)
   */
  public RK getResourceKit(final Repository repository, final URFResource resource, final Capability... capabilities);
  </code></pre>
  
  <p>Since the project is public, here is a link for the pull request of what I've done for fixing the javadocs: <a href="https://bitbucket.org/globalmentor/marmot/pull-requests/2/marmot-5-fixed-javadoc-errors/diff" rel="nofollow">Bitbucket - Globalmentor's Project: MARMOT-5</a></p>