Javadocs and CSS

[Scott Palmer]

Created https://javafx-jira.kenai.com/browse/RT-37168


On Fri, May 16, 2014 at 10:57 AM, David Grieve <david.grieve at oracle.com> wrote:
> Would you mind creating a bug for this?
>
>
> On 5/16/14, 10:38 AM, Scott Palmer wrote:
>>
>> Should a better cross-reference or mention of CSS properties in the
>> Javadocs?
>>
>> Many properties can be set via calling methods or through CSS, but
>> when browsing the Javadocs the related CSS properties are not
>> mentioned (at least not in most cases).
>>
>> The package docs for javafx.scene mention the CSS Reference Guide at
>> the end of the description, and careful reading of that document
>> mentions the convention used to go from JavaFX variable names to CSS
>> property. (last paragraph of
>>
>> http://docs.oracle.com/javase/8/javafx/api/javafx/scene/doc-files/cssref.html#introscenegraph)
>>
>> I think all that is needed is to mention in the JavaDocs if the
>> property is configurable from CSS or not. Or at least mention the
>> exceptions to the rule.  For example most properties of Labeled are
>> configurable via CSS, but "lineSpacing" and "mnemonicParsing" are
>> *not* mentioned among the CSS properties.
>>
>> (http://docs.oracle.com/javase/8/javafx/api/javafx/scene/doc-files/cssref.html#labeled)
>>
>>
>> Scott
>
>