Currently I'm referencing methods in other classes with this Javadoc syntax:
@see {@link com.my.package.Class#method()}
And in what I understand from the documentation this is the correct way to do this. But now to the funny part, or frustrating. When I generate this javadoc I first of all get following error:
warning - Tag @see:illegal character: "123" in "{@link com.my.package.Class#method()}"
warning - Tag @see:illegal character: "64" in "{@link com.my.package.Class#method()}"
warning - Tag @see: reference not found: {@link com.my.package.Class#method()}
The Generated HTML code of this is:
"," <code>com.my.package.Class#method()}</code> ","
And of course I have no link. Can anyone tell me what's happening, and any hints on how to fix this?
According to the ASCII table characters 123 and 64 for wold represent { and @, so why aren't these characters valid when this syntax is correct according to the documentation?
com.my.package.Class
in the class this JavaDoc is written? The reference not found seems odd. On the other hand, I've never used them combined but there's a chance that@see
and@link
conflict with each other, taking that@see
generates its own seciton it wouldn't surprise me. – Fritz Jul 5 '13 at 20:07@see
tag in your javadoc. To fix it in this case wrap the hyperlink in an html anchor element:/** @see <a href="http://example.com">Example</a> */
– cyber-monk Jul 31 '15 at 23:14