RFR: 8354478: Improve StageStyle documentation

[Nir Lisker]

On Sun, 13 Apr 2025 15:24:43 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)

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

> 56: 
> 57:     /**
> 58:      * Defines a lightweight {@code Stage} with minimal decorations, intended for

Is there a reason you removed use the word "style" here? The other ones use it.

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

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