RFR: 8271091: Missing API docs in UI controls classes

[Michael Strauß]

On Wed, 20 Oct 2021 15:23:07 GMT, Nir Lisker <nlisker at openjdk.org> wrote:

>> This PR fixes javadoc warnings in javafx.controls and javafx.web modules.
>> Note : 
>> - The javadoc needs to be generated with the JDK 18 EA build.
>> - There are still 20 javadoc warnings remaining in javafx.controls module and 3 warnings remaining in javafx.web module. The root cause is different and they will be addressed under [JDK-8270996](https://bugs.openjdk.java.net/browse/JDK-8270996)
>
> modules/javafx.controls/src/main/java/javafx/scene/control/Control.java line 874:
> 
>> 872: 
>> 873:     /**
>> 874:      * Get the unmodifiable list of the controls css styleable properties.
> 
> Maybe "Gets the unmodifiable list of the control's css styleable properties."? I'm not sure what this method really does, but if it relates to a single control then that apostrophe is needed.

Also, "CSS" should probably be upper-cased in a sentence, like so: "CSS-styleable"

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

PR: https://git.openjdk.java.net/jfx/pull/646