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

[Jonathan Gibbons]

On Sat, 23 Apr 2022 17:03:06 GMT, Jonathan Gibbons <jjg at openjdk.org> 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](https://bugs.openjdk.java.net/browse/JDK-8285496)

This pull request has now been integrated.

Changeset: 20a132d4
Author:    Jonathan Gibbons <jjg at openjdk.org>
URL:       https://git.openjdk.java.net/jdk/commit/20a132d460bc34fbf59774bc7493d93472b7d52a
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

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

PR: https://git.openjdk.java.net/jdk/pull/8375