RFR: 8267708: Remove references to com.sun.tools.javadoc.**

Tue May 25 21:44:35 UTC 2021

On Tue, 25 May 2021 17:46:59 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> src/jdk.compiler/share/classes/com/sun/tools/javac/api/JavacTrees.java line 627:
>> 
>>> 625:     }
>>> 626: 
>>> 627:     /** @see com.sun.tools.javadoc.ClassDocImpl#findField */
>> 
>> Is there an equivalent new-style method that should be used instead?
>
> The most likely justification for all these ClassDocImpl references is now in `ReferenceTree`.

A doc comment consisting solely of an `@see` tag has unclear semantics. The methods I removed such doc comments from are private and can be used only from their enclosing instance.

-------------

PR: https://git.openjdk.java.net/jdk/pull/4192