title: Javadoc bug: @link can't handle Generics "<>"
body: <p>Consider a static method in a class, which I have documented it using <a href="http://en.wikipedia.org/wiki/Javadoc" rel="noreferrer">javadoc</a>:</p>
  
  <pre class="lang-java prettyprint-override"><code>/**
   * Description here.
   *
   * @param names       - The parameters of the impression request.
   * @param ids         - An intent object to enrich.
   * @param prefix - A prefix.
   */
  
  public static void parse(Map&lt;String, String&gt; names, String ids, String prefix)
      ...
  </code></pre>
  
  <p>In order to avoid duplicating the description in the overloaded versions of the method, I would like to use a javadoc <code>@link</code>:</p>
  
  <pre class="lang-java prettyprint-override"><code> /**
   * Overloaded version with default prefix.
   * {@link #&lt;parse(Map&lt;String, String&gt;, String, String)&gt; [Text]}
   */
  
  public static void parse(Map&lt;String, String&gt; names, String ids, String prefix)
  </code></pre>
  
  <p>Which gives the following warning:</p>
  
  <pre class="lang-java prettyprint-override"><code>@link:illegal character: "60" in "#parseBtCategories(Map&lt;String, String&gt;, 
                                                       String, String) Text"
  </code></pre>
  
  <p>ASCII 60 is <code>&lt;</code>, which is a part of the method signature. It works with <code>Map, String, String)</code> nut this notation can't distinguish two different types of maps.</p>
  
  <p><a href="http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6435888" rel="noreferrer">This seems to be a known bug.</a> Is there a good workaround?</p>