[jfx17] RFR: 8250590: Classes and methods in the javafx.css package are missing documentation [v2]

[Kevin Rushforth]

On Tue, 27 Jul 2021 10:00:10 GMT, Ajit Ghaisas <aghaisas at openjdk.org> wrote:

>> modules/javafx.graphics/src/main/java/javafx/css/converter/EffectConverter.java line 83:
>> 
>>> 81:     /**
>>> 82:      * Converter to convert DropShadow {@code Effect}
>>> 83:      * @since 9
>> 
>> Good catch on the `@since 9` tag. I'm a little surprised it doesn't inherit the `@since` from the enclosing class if not present in the nested class, but I can see that it doesn't. So we'll to check the docs of all nested classes to make sure that there aren't any missing.
>
> This can only be checked manually.
> I have checked and added the @since tag to these *Converter nested classes.

I ran a script to check for missing `@since` tags. The following class are still missing them:


DeriveColorConverter
DeriveSizeConverter
StopConverter
StringConverter.SequenceConverter

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

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