Integrated: JDK-8269774: doclint reports missing javadoc comments for JavaFX properties if the docs are on the property method

Jonathan Gibbons jjg at openjdk.java.net
Wed Aug 11 18:07:34 UTC 2021


On Fri, 9 Jul 2021 19:17:04 GMT, Jonathan Gibbons <jjg at openjdk.org> wrote:

> Please review a simple change to the code for generating docs for JavaFX properties, in order to suppress an inappropriate
> "missing comment" warning.
> 
> The change is to use `hasDocCommentTree` instead of `getDocCommentTree`.
> 
> A new test is added, that runs javadoc on similar classes, with and without a comment on the field for a property. In both cases, no warnings about missing comments should be generated, and when the comment is available, it is used as expected.

This pull request has now been integrated.

Changeset: 9ba8a12c
Author:    Jonathan Gibbons <jjg at openjdk.org>
URL:       https://git.openjdk.java.net/jdk/commit/9ba8a12cfbb3d7d17be454e29ee6ff476c8690c2
Stats:     160 lines in 2 files changed: 159 ins; 0 del; 1 mod

8269774: doclint reports missing javadoc comments for JavaFX properties if the docs are on the property method

Reviewed-by: kcr, hannesw

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

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


More information about the javadoc-dev mailing list