RFR: 8346659: SnippetTaglet should report an error if provided ambiguous links [v3]

[Nizar Benalla]

> Some javadoc snippets can match multiple links to the same content, leading to different results in different javadoc runs.
> This patch proposes emitting an error when such cases are encountered.
> 
> There is a very trivial, unrelated change in `TestGlobalHtml.java` because I noticed some whitespace wasn't right.

Nizar Benalla 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 four additional commits since the last revision:

 - Merge remote-tracking branch 'upstream/master' into snippet-non-rep
 - adjusting error message
 - Merge remote-tracking branch 'upstream/master' into snippet-non-rep
 - emit error when encountering ambigious link

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/23328/files
  - new: https://git.openjdk.org/jdk/pull/23328/files/debbac71..5ee95f7e

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=23328&range=02
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=23328&range=01-02

  Stats: 28750 lines in 841 files changed: 12695 ins; 9902 del; 6153 mod
  Patch: https://git.openjdk.org/jdk/pull/23328.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/23328/head:pull/23328

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