Re: [Patch] 8081820: Generate warnings for multiple «@param» and «@return»

[Jonathan Gibbons]

On 01/09/2017 05:29 PM, Denis Istomin wrote:
> Hi,
> Made patch for bug 8081820. Warnings are generated in doclint.
>
> -- 
> Denis Istomin

Denis,

The changes to the mainline src/ code look OK, but your two new tests do 
not follow
the pattern of existing tests. If you look at a random test, such as 
EndTagsTest,
you'll see there are a couple of @run main lines.

EndTagsTest.java: * @run main DocLintTester -Xmsgs:-html EndTagsTest.java
EndTagsTest.java: * @run main DocLintTester -ref EndTagsTest.out 
EndTagsTest.java

The purpose of the pair is that together they verify the checks are 
enabled in
the right category.  The first line verifies that no output is generated 
for bad input
when the category is disabled; the second line verifies that the 
expected output
is generated when the category is not disabled.

-- Jon