Community
Participate
Working Groups
1) enabled "problems in javadoc tags" 2) create X.java /** * @see X * @see X#X(int) * @see X(double) * @see X!=}} * @see foo() */ public class X { public X(int i){} public void foo() } 3) compile "@see X(double)" and "@see X!=}}" have no error. "@see foo()" has an error. These @see tags are considered as type reference and the following text is ignored. Perhaps it should be not ignored.
Javadoc spec 1.4 precise that after @see <reference> user can only put a label. Currently compiler does not verify the end of the line after the reference in @see tag. He has to do it...
Ignore my last comment, the label can be a sentence. * @see <reference> A sentence which can include embedded tag: {@link String} is a valid @see reference... I think the solution may be to verify that there's a white space after the type reference. * @see X(double) would be invalid altough * @see X (double) would be valid. Another solution would be to verify that first token after the referenced type is not a open parenthesis. This would avoid confusion with method/constructor reference. * @see X(double) * @see X (double) would be both invalid * @see X My test class * @see X [My test class] * @see X[My test class] would be valid. Your opinion?
Ok by me.
Fixed using second solution... Test case added in tests.compiler.regression.JavadocTestMixed
Verified for 3.0M6