On Sat, 23 Apr 2022 17:03:06 GMT, Jonathan Gibbons <j...@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 <j...@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
