RFR: 8284908: Refine diagnostic positions for DCErroneous [v3]

[Pavel Rappo]

> Before:
> 
> Standard Doclet version 18+36-2087
> Building tree for all the packages and classes...
> Generating /tmp/whatever/ExampleDiagnostics.html...
> ExampleDiagnostics.java:5: error: unexpected content
>      * {@docRoot a}
>        ^
> ExampleDiagnostics.java:11: error: unexpected content
>      * {@inheritDoc a}
>        ^
> ExampleDiagnostics.java:17: error: '>' expected
>      * @param <T param
>                      ^
> 
> After:
> 
> Standard Doclet version 19-internal-2022-04-07-1105474.pavelrappo...
> Building tree for all the packages and classes...
> Generating /tmp/whatever/ExampleDiagnostics.html...
> ExampleDiagnostics.java:5: error: unexpected content
>      * {@docRoot a}
>                  ^
> ExampleDiagnostics.java:11: error: unexpected content
>      * {@inheritDoc a}
>                     ^
> ExampleDiagnostics.java:17: error: '>' expected
>      * @param <T param
>                 ^

Pavel Rappo 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 five additional commits since the last revision:

 - Merge branch 'master' into 8284908
 - Address feedback
 - Update copyright years
 - Specify preferred diagnostic positions
 - Print prefPos in header if prefPos is defined
   
   This is a test only change.

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

Changes:
  - all: https://git.openjdk.java.net/jdk/pull/8264/files
  - new: https://git.openjdk.java.net/jdk/pull/8264/files/7bce75a6..7b66b3d6

Webrevs:
 - full: https://webrevs.openjdk.java.net/?repo=jdk&pr=8264&range=02
 - incr: https://webrevs.openjdk.java.net/?repo=jdk&pr=8264&range=01-02

  Stats: 13184 lines in 918 files changed: 7976 ins; 2097 del; 3111 mod
  Patch: https://git.openjdk.java.net/jdk/pull/8264.diff
  Fetch: git fetch https://git.openjdk.java.net/jdk pull/8264/head:pull/8264

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