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

[Jonathan Gibbons]

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

>> Although the `com.sun.tools.javadoc.**` packages were removed in JDK-8215584, some references to them remain, mainly in the form of links in doc comments. Some of those links refer to classes that never existed, which I reckon is due to a typo; for example, this reference
>> 
>>     com.sun.tools.javadoc.ClassDocImpl#findField
>> 
>> should've looked like this
>> 
>>     com.sun.tools.javadoc.main.ClassDocImpl#findField
>> 
>> Grep showed that some tests also use `com.sun.tools.javadoc` and some other extinct packages. However, it is unclear if those "references" should also be removed:
>> 
>> 1. https://github.com/openjdk/jdk/blob/739769c8fc4b496f08a92225a12d07414537b6c0/test/langtools/tools/javac/NoStringToLower.java#L60-L74
>> 2. https://github.com/openjdk/jdk/blob/739769c8fc4b496f08a92225a12d07414537b6c0/test/langtools/tools/javac/T8003967/DetectMutableStaticFields.java#L73-L85
>
> 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`.

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

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