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

[Chen Liang]

On Tue, 28 Jan 2025 11:23:36 GMT, Nizar Benalla <nbenalla at openjdk.org> wrote:

> 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.

test/langtools/jdk/javadoc/doclet/TestGlobalHtml/TestGlobalHtml.java line 29:

> 27:  * @summary  Test to make sure global tags work properly
> 28:  * @library  /tools/lib ../../lib
> 29:  * @modules  jdk.javadoc/jdk.javadoc.internal.tool

Redundant change?

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

PR Review Comment: https://git.openjdk.org/jdk/pull/23328#discussion_r1932476957