On Tue, 25 May 2021 22:17:51 GMT, Jonathan Gibbons <j...@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
