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

[Nizar Benalla]

On Tue, 28 Jan 2025 16:21:08 GMT, Chen Liang <liach 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?

> There is a very trivial, unrelated change in TestGlobalHtml.java because I noticed some whitespace wasn't right.

I noticed the missing space because I copied the jtreg comment from it, seems harmful to fix.

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

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