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).

N/A

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.

  xxxxx@xxxxx   2002-09-26