[jdk11u] RFR: 8292434: javadoc generation fails if javadoc contains @see with generics [v2]

[Paul Hohensee]

On Wed, 23 Nov 2022 00:53:43 GMT, Bo Zhang <duke at openjdk.org> wrote:

>> This is a backport of JDK-8177280.
>
> Bo Zhang has refreshed the contents of this pull request, and previous commits have been removed. The incremental views will show differences compared to the previous content of the PR. The pull request contains one new commit since the last revision:
> 
>   8292434: javadoc generation fails if javadoc contains @see with generics
>   
>   This is a backport of JDK-8177280.

This is a backport of [JDK-8177280](https://bugs.openjdk.org/browse/JDK-8177280) and thus doesn't require that you file a separate JBS issue: that will be done by the hg-updater bot when the backport is pushed. Please close [JDK-8292434](https://bugs.openjdk.org/browse/JDK-8292434) and change this PR title to "Backport b43f356288315eb56b848e57c0dcfc9c31a640cc", which should cause the github openjdk bot to recognize the PR as a backport. "b43f356288315eb56b848e57c0dcfc9c31a640cc" is the original commit-id from the https://github.com/openjdk/jdk repo.

I just noticed that this PR was filed against the jdk11u repo rather than the jdk11u-dev repo. You'll have to close this one and open one against the jdk11u-dev repo.

In DocTrees.java, the later copyright date should be 2020, not 2022. @since on getType() should be 15, not 11.

In Checker.java, no copyright date update is needed.

In JavacTrees.java, the later copyright date should be 2020, not 2022. The new line 733 should not replace the old line 708.

In HtmlDocletWriter.java, no copyright date update is needed.

In LinkFactoryImpl.java, no copyright date update is needed.

In LinkInfoImpl.java, the declaration/definition and use of ALL_CLASSES_FRAME hasn't been removed.

In CommentHelper.java, there's modified code that isn't modified in the original commit, which implies there's a predecessor backport to be done before this one. Look at the git log for this file to see what that might be.

For more information on how to do backports, see

8u wiki: https://wiki.openjdk.org/display/jdk8u/Main
11u and later wiki: https://wiki.openjdk.org/display/JDKUpdates/JDK11u
11u wiki: https://wiki.openjdk.org/display/JDKUpdates/JDK11u
Skara (CLI tools): https://wiki.openjdk.org/display/SKARA
Backports: https://wiki.openjdk.org/display/SKARA/Backports

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

Changes requested by phh (Reviewer).

PR: https://git.openjdk.org/jdk11u/pull/61