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

Jonathan Gibbons jonathan.gibbons at oracle.com
Fri Jan 27 23:53:19 UTC 2017


Denis,

We wanted to get this issue closed out, so I have made the minor 
corrections to your
patch and pushed it on your behalf.

Thank you for your contribution.

-- Jon


On 01/24/2017 06:29 PM, Jonathan Gibbons wrote:
>
>
> 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



More information about the javadoc-dev mailing list