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

[Jonathan Gibbons]

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

>> 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.
>
> Let me go do some archaeology. While the comments may have been substandard, I would still like to recall their intent.

The notable content of the comments on those `ClassDocImpl` methods is that they document (I hesitate to use the "specify" word) the search order, with the additional comment *Note that this is not necessarily what the compiler would do!*

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

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