[External] : Re: Mention of the CSS properties in JavaDocs

[Kevin Rushforth]

 > So I suppose going back to a custom doclet again will not be a 
preferable solution.

You're right; this would not be a preferred solution.

-- Kevin


On 2/15/2022 9:37 PM, Anirvan Sarkar wrote:
> JavaFX 2 provided a custom doclet [1] but this was not required since 
> JavaFX 8 (JDK 8).
> If a custom doclet is introduced again, we need to modify build 
> scripts / IDE settings, etc. which is not required since JDK 12 [2].
> So I suppose going back to a custom doclet again will not be a 
> preferable solution.
>
> [1] : https://docs.oracle.com/javafx/2/doclet/jfxpub-doclet.htm
> [2] : https://bugs.openjdk.java.net/browse/JDK-8208532
>
> On Mon, 14 Feb 2022 at 02:34, Scott Palmer <swpalmer at gmail.com> wrote:
>
>     Would it be a custom doclet that was part of the OpenJFX project
>     and require no changes to the javadoc tool?
>
>     Scott
>
>     > On Feb 12, 2022, at 9:52 AM, Kevin Rushforth
>     <kevin.rushforth at oracle.com> wrote:
>     >
>     > While something like this could be handy, I doubt that adding
>     this much knowledge of JavaFX into the javadoc tool would gain any
>     traction.
>     >
>     > -- Kevin
>     >
>     >
>     > On 2/9/2022 7:11 AM, Nir Lisker wrote:
>     >> Hi,
>     >>
>     >> When reviewing the docs changes to TabPane, I saw that some
>     properties
>     >> mention the CSS that is related to them. I was wondering if we
>     could
>     >> standardize it through something like a @css tag that is given
>     the css
>     >> string constant, or read automatically through the CssMetaData.
>     >>
>     >> As an example:
>     >>
>     >>     /**
>     >>      * Specifies the maximum width of a tab.
>     >>      * ...
>     >>      * @css -fx-tab-max-width
>     >>      * @defaultValue 10
>     >>      */
>     >>
>     >> If the javadoc tool has access to these during its runtime, it
>     can read the
>     >> string by looking in the getCssMetaData() override of the
>     property and then
>     >> read the first argument of the CssMetaData constructor.
>     >>
>     >> Thoughts?
>     >
>
>
>
> -- 
> Anirvan