javadoc handles nested generic types incorrectly

[Jonathan Gibbons]

Martin,

This will show up soon on bugs.sun.com as 6758050

-- Jon


Martin Buchholz wrote:
> Hi Javadoc maintainers,
>
> This is a bug report.
>
> My colleague Jared Levy reports:
>
> The following file yields invalid Javadoc, even with jdk1.7.0-b36
>
> ---------------------------------
> import java.util.Map;
>
> /** Contains {@link #foo} */
> public class Nested {
>   public static <A> void foo(Map<A, Map<A, A>> map) {}
> }
> ---------------------------------
>
> The generated Nested.html contains:
>
> Contains <A HREF="Nested.html#foo(java.util.Map)"><CODE>foo(java.util.Map<A,
> java.util.Map<A, A>>)</CODE></A>
>
> Clearly some of the < and > characters need to be replaced with &lt; and &gt;
> Firefox confusingly displays exactly one of the four expected angle brackets.
> I hope your mail reader doesn't mangle this pure text message.
>
> Martin
>