Community
Participate
Working Groups
Using 1216, we should not report a deprecation warning if the @deprecated tag is preceeded with something else than whitespaces or '*'. Compiling the following code should not add a deprecated attribute to the class: [ /** * this should not be here @deprecated */ class A {} ]
Please find some official confirmation of this behavior
This is stated in the javadoc specs. Any tag has to be at the beginning of the line preceeded only with whitespaces and/or a asterisk. From this link: http://java.sun.com/j2se/1.4/docs/tooldocs/windows/javadoc.html Standalone and in-line tags - A tag is a special keyword within a doc comment that the Javadoc tool can process. The Javadoc tool has standalone tags, which appear as @tag, and in-line tags, which appear within braces, as {@tag}. To be interpreted, a standalone tag must appear at the beginning of a line, ignoring leading asterisks, white space, and separator (/**). This means you can use the @ character elsewhere in the text and it will not be interpreted as the start of a tag. If you want to start a line with the @ character and not have it be interpreted, use the HTML entity @. Each standalone tag has associated text, which includes any text following the tag up to, but not including, either the next tag, or the end of the doc comment. This associated text can span multiple lines. An in-line tag is allowed and interpreted anywhere that text is allowed. The following example contains the standalone tag @deprecated and in-line tag {@link}.
Fixed and released in 2.1 stream.
Verified.