On Fri, 22 Oct 2021 14:48:31 GMT, Nir Lisker <nlis...@openjdk.org> wrote:
>> This PR fixes javadoc warnings primarily in javafx.graphics module along >> with a remaining few in javafx.fxml, javafx.base and javafx.media modules. >> >> Note : >> - The javadoc needs to be generated with the JDK 18 EA build. >> - There are still few remaining warnings in these modules. The root cause is >> different and they will be addressed under >> [JDK-8270996](https://bugs.openjdk.java.net/browse/JDK-8270996) > > modules/javafx.graphics/src/main/java/javafx/scene/Camera.java line 164: > >> 162: /** >> 163: * Creates a {@code Camera}. >> 164: */ > > Sine the constructor is a `protected` for an `abstract` class, it doesn't > create a `Camera` in the normal sense of constructors. I would write > something like "Shared constructor for subclasses of `Camera`". Good catch. We've started using "Constructor for subclasses to call." as the description of such classes. See PR #283 for example. ------------- PR: https://git.openjdk.java.net/jfx/pull/650
