RFR: JDK-8262992: Improve `@see` output [v2]

[Hannes Wallnöfer]

On Thu, 11 Mar 2021 15:16:17 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

>> Hannes Wallnöfer has updated the pull request incrementally with one additional commit since the last revision:
>> 
>>   Update `@see` tag in class java.security.cert.PKIXRevocationChecker
>
> test/langtools/jdk/javadoc/doclet/testSingletonLists/TestSingletonLists.java line 287:
> 
>> 285:                     Map<String,Integer> c = counts.pop();
>> 286:                     if (inSeeList) {
>> 287:                         // Ignore "Constant Field Values" @see items for final fields created by javadoc
> 
> I think the comment is too specific. Won't the problem also be triggered for classes with a single `@see` and no constant values?  It m might also be triggered on serializable classes, with the link to the `Serialized Form`.

Yes, the problem could be triggered by various circumstances, but in this particular test (which doesn't contain any explicit `@see` tags) it is just the automatically generated "see also" link to the constant field values page. The fields in question can't be made non-final because they are in annotation interfaces, btw.

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

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