Integrated: JDK-8284994: -Xdoclint:all returns warning for records, even when documented properly

Jonathan Gibbons jjg at
Tue Apr 26 15:45:47 UTC 2022

On Sat, 23 Apr 2022 17:03:06 GMT, Jonathan Gibbons <jjg at> wrote:

> Please review a small fix to address issues with records in DocLint when invoked from javac. Bottom line, record components or their fields should never have direct documentation comments (and so the absence of comments should not be reported as "missing") ... they should be documented with `@param` tags in the doc comment for the record itself.
> In the course of this work, it was observed that DocLint does not check for `@param` tags for type parameters on a class or interface declaration. Fixing that uncovers issues in the JDK API documentation, so that part of the fix is disabled for now, and a followup bug has been filed. [JDK-8285496](

This pull request has now been integrated.

Changeset: 20a132d4
Author:    Jonathan Gibbons <jjg at>
Stats:     88 lines in 5 files changed: 69 ins; 1 del; 18 mod

8284994: -Xdoclint:all returns warning for records, even when documented properly

Reviewed-by: vromero



More information about the compiler-dev mailing list