RFR: 8354478: Improve StageStyle documentation

[Andy Goryachev]

On Mon, 14 Apr 2025 13:29:08 GMT, John Hendrikx <jhendrikx at openjdk.org> wrote:

>> Improve StageStyle Documentation
>> 
>> - Update `StageStyle.UTILITY`:
>> Clarified that UTILITY stages may impose platform-specific restrictions on window states, such as preventing maximize, minimize (iconify), and fullscreen operations.
>> 
>> - Update `StageStyle.UNDECORATED`:
>> Improved the description to clarify that although UNDECORATED removes standard window decorations (title bar, borders, and controls), window operations like minimize, maximize, and fullscreen may still be allowed programmatically or via platform-specific functions such as key shortcuts or menu options.
>> 
>> - Remove mention of solid white background:
>> This seems to be not true anymore, even withou a `Scene` (or there's a bug)
>
> modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java line 44:
> 
>> 42:      * This style allows window operations such as resize, minimize, maximize
>> 43:      * and fullscreen to be either programmatically controlled or achieved through
>> 44:      * platform-specific functions, such as key shortcuts or menu options.
> 
> It looks like you intend the 2nd part to be a new paragraph:
> Suggestion:
> 
>      * Defines a {@code Stage} style with no window decorations, such as a title bar,
>      * borders, or window controls.
>      * <p>
>      * This style allows window operations such as resize, minimize, maximize
>      * and fullscreen to be either programmatically controlled or achieved through
>      * platform-specific functions, such as key shortcuts or menu options.

+1

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1776#discussion_r2042286028