--- old/src/java.desktop/share/classes/java/awt/Window.java 2020-03-23 03:15:14.000000000 -0700 +++ new/src/java.desktop/share/classes/java/awt/Window.java 2020-03-23 03:15:14.000000000 -0700 @@ -134,6 +134,13 @@ * geometry in order to place and size the {@code Window} in a way * that more closely matches the desktop settings. *
+ * The visual appearance and behavior of top-level windows (including + * normal/shaped/translucent/undecorated {@code Window}s, {@code Frame}s, + * {@code Dialog}s) are under the control of the desktop's window management + * system. The visual effects as shadows, motion effects, animations, + * and others may not be controlled by the applications but work according to + * the desktop settings. + *
* Due to the asynchronous nature of native event handling, the results * returned by {@code getBounds}, {@code getLocation}, * {@code getLocationOnScreen}, and {@code getSize} might not