Community
Participate
Working Groups
While writing javadoc I auto-selected the method, but the inserted reference generates an error - surely it shouldn't (either the insertion is wrong or the parsing of javadoc is broken). % cat Test.java /** * Comment */ public final class Test { /** * Do something with the ip. * * @param <T> the type this is for * @param ip the ip. */ public <T> void myMethod(Iterable<? extends T> ip) { assert ip != null; } // The next line contains the problem. /** Test {@link Test#myMethod(Iterable<? extends T>) myMethod}. */ public void fooey() { } /** Test {@link Test#myMethod(Iterable) myMethod}. */ public void bluey() { } }
Javadoc 1.5 spec does not allow generic in references. Syntax for @see or @link references hasn't changed since 1.4, user has to use raw types to refer to types or methods... Note that javadoc.exe also reports error on this reference: D:\usr\OTI\workspaces\tests\bugs\Divers15\b87869\Test.java:17: warning - Tag @link:illegal character: "60" in "Test#myMethod(Iterable<? extends T>) myMethod" D:\usr\OTI\workspaces\tests\bugs\Divers15\b87869\Test.java:17: warning - Tag @link:illegal character: "63" in "Test#myMethod(Iterable<? extends T>) myMethod" D:\usr\OTI\workspaces\tests\bugs\Divers15\b87869\Test.java:17: warning - Tag @link:illegal character: "62" in "Test#myMethod(Iterable<? extends T>) myMethod" Move to JDT/Text
*** This bug has been marked as a duplicate of 87868 ***