[jdk17u-dev] RFR: 8281944: JavaDoc throws java.lang.IllegalStateException: ERRONEOUS

[Aleksey Shipilev]

Fixes a javadoc crash on incorrect `@see`. We have seen instances of this in our development pipelines. 

Unfortunately, javadoc code changed considerably in modern releases. The original patch, while simple, does not apply well to javadoc from JDK 17. The backports of javadoc improvements that would make this clean to JDK 17 are hairy. So instead I amended the patch to work on JDK 17, see https://github.com/openjdk/jdk17u-dev/commit/9249ee405fc0a8b4653a653c1150692b90319bd9.

Additional testing:
 - [x] New test fails without the patch, passes with it
 - [x] MacOS AArch64 server fastdebug, `jdk/javadoc` pass

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

Commit messages:
 - Adjustments for JDK 17
 - Backport 0796620b07c6287a130ab0a3a7279d69b5d7b8a1

Changes: https://git.openjdk.org/jdk17u-dev/pull/2546/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk17u-dev&pr=2546&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8281944
  Stats: 51 lines in 2 files changed: 47 ins; 0 del; 4 mod
  Patch: https://git.openjdk.org/jdk17u-dev/pull/2546.diff
  Fetch: git fetch https://git.openjdk.org/jdk17u-dev.git pull/2546/head:pull/2546

PR: https://git.openjdk.org/jdk17u-dev/pull/2546