JDK-8031212 : doclint incorrectly rejects some @see tags in javadoc comments
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Priority: P2
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2014-01-06
  • Updated: 2014-07-30
  • Resolved: 2014-01-28
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8 JDK 9
8u20Fixed 9 b03Fixed
Description
doclint incorrectly rejects 
    @see "string"

if it is not immediately followed by another block level tag.    This means it rejects @see "string" when it is the last tag in the comment.

Comments
This issue was first noted in a post to javadoc-dev -- see links.
06-01-2014