--- old/src/java.desktop/share/classes/java/awt/Toolkit.java	2015-09-23 21:36:56.000000000 +0300
+++ new/src/java.desktop/share/classes/java/awt/Toolkit.java	2015-09-23 21:36:56.000000000 +0300
@@ -208,11 +208,13 @@
     }
 
     /**
-     * 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