src/java.desktop/share/classes/java/awt/Toolkit.java

@@ -206,15 +206,17 @@
             return false;
         }
     }
 
     /**
-     * Returns whether dynamic layout of Containers on resize is
-     * currently active (both set in program
-     *( {@code isDynamicLayoutSet()} )
-     *, and supported
-     * by the underlying operating system and/or window manager).
+     * Returns whether dynamic layout of Containers on resize is currently
+     * active (both set in program ({@code isDynamicLayoutSet()}), and supported
+     * by the underlying operating system and/or window manager). Note that on
+     * platforms where dynamic layout during resizing is not supported (or is
+     * always supported) by the OS/WM, ({@code isDynamicLayoutSet()}) property
+     * has no effect.
+     * <p>
      * If dynamic layout is currently inactive then Containers
      * re-layout their components when resizing is completed. As a result
      * the {@code Component.validate()} method will be invoked only
      * once per resize.
      * If dynamic layout is currently active then Containers