RFR: 8370237: AssertionError in Annotate.fromAnnotations with -Xdoclint and type annotations [v5]

[Liam Miller-Cushon]

> Hi, please consider this fix for a crash with `-Xdoclint` and type annotations. It is a generalization of a previous fix for [JDK-8266082](https://bugs.openjdk.org/browse/JDK-8266082).

Liam Miller-Cushon has updated the pull request with a new target base due to a merge or a rebase. The incremental webrev excludes the unrelated changes brought in by the merge/rebase. The pull request contains six additional commits since the last revision:

 - Merge remote-tracking branch 'origin/master' into JDK-8370237
 - Undo accidental update of examples.not-yet.txt
 - Update examples.not-yet.txt
 - Fix typo in test
 - Update another affected test
 - 8370237: AssertionError in Annotate.fromAnnotations with -Xdoclint and type annotations

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/27901/files
  - new: https://git.openjdk.org/jdk/pull/27901/files/152ef5fa..a05973c6

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=27901&range=04
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=27901&range=03-04

  Stats: 21830 lines in 532 files changed: 13148 ins; 5780 del; 2902 mod
  Patch: https://git.openjdk.org/jdk/pull/27901.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/27901/head:pull/27901

PR: https://git.openjdk.org/jdk/pull/27901