RFR: 8354478: Improve StageStyle documentation [v2]

[Nir Lisker]

On Mon, 14 Apr 2025 15:13:19 GMT, Thiago Milczarek Sayao <tsayao 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)
>
> Thiago Milczarek Sayao has updated the pull request incrementally with two additional commits since the last revision:
> 
>  - Add "style" ib the UTILITY style like the others
>  - Update modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java
>    
>    Co-authored-by: John Hendrikx <john.hendrikx+github at gmail.com>

modules/javafx.graphics/src/main/java/javafx/stage/StageStyle.java line 41:

> 39:     /**
> 40:      * Defines a {@code Stage} style with no window decorations, such as a title bar,
> 41:      * borders, or window controls.

Any particular reason you removed "a solid background" like `DECORATED` has? The previous docs give that detail.

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

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