RFR: 8313424: JavaFX controls in the title bar [v49]

[Michael Strauß]

On Tue, 18 Feb 2025 19:55:58 GMT, Andy Goryachev <angorya at openjdk.org> wrote:

>> `cssref.html` is the normative reference for the JavaFX CSS API. `HeaderButtonOverlay` is not API, it can't be styled by developers, it's completely inaccessible, and therefore must not be specified anywhere.
>> 
>> It's even unspecified whether `HeaderButtonOverlay` is used _at all_. For example, on macOS it's never used.
>
> `cssref.html` **_IS_** a part of normative reference for JavaFX API.
> 
> And my comment is not limited to a single class, it applies to every new CSS property added here.

It seems we're going in circles here. You want me to specify something which I've repeatedly explained is not API. I can't specify something which is not API.

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1605#discussion_r1960521256