4754029 : Doclet API: Rewrite doc comments in com.sun.javadoc.SeeTag
Many of the doc comments in SeeTag are quite different from the actual
implementation and are also vague and incomplete. For instance, the example
in referencedClassName() says that for @see String#startsWith(java.lang.String)
it returns String when it actually returns java.lang.String, and doesn't
mention what happens when @see references only a package name (the
package name is returned).
BugTraq+ Release Management Values
COMMIT TO FIX:
Revised the doc comments as suggested.
No regression test required as this is a doc comment change.
I spoke with Neal sometime back and he agreed with me it's too late
to change the implementation to conform to the doc comments -- we should
change the doc comments to conform to the implementation.
We need to be careful not to over-specify things that we may want to
change in the implementation.