On Tue, 16 Jun 2026 19:36:52 GMT, Phil Race <[email protected]> wrote:

> This update to the documentation is motivated by regular bug reports 
> complaining that some case using a platform L&F does not render as the 
> documentation suggests. This is usually because the javadoc was written for 
> L&Fs under the control of Swing. Whereas for platform L&Fs the goal is to 
> render consistently with the platform.
> 
> ---------
> - [x] I confirm that I make this contribution in accordance with the [OpenJDK 
> Interim AI Policy](https://openjdk.org/legal/ai).

Marked as reviewed by psadhukhan (Reviewer).

src/java.desktop/share/classes/javax/swing/UIManager.java line 187:

> 185:  * <li>specified rendering of painted borders may be ignored
> 186:  * <li>specified rendering of highlighting effects may be ignored
> 187:  * <li>specified rendering of painted backgrounds and foreground may be 
> ignored

foregrounds?

src/java.desktop/share/classes/javax/swing/UIManager.java line 195:

> 193:  * These caveats must not be construed as an excuse to arbitrarily 
> ignore these properties.
> 194:  * They are intended to support the requirement that the platform Look 
> and Feel be as
> 195:  * faithful to the native rendering as is practical.

to me "as consistent with the native rendering as practical" looks better

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

PR Review: https://git.openjdk.org/jdk/pull/31538#pullrequestreview-4512448398
PR Review Comment: https://git.openjdk.org/jdk/pull/31538#discussion_r3425633702
PR Review Comment: https://git.openjdk.org/jdk/pull/31538#discussion_r3425644914

Reply via email to