src/java.desktop/share/classes/java/awt/geom/AffineTransform.java

@@ -1159,11 +1159,12 @@
         }
     }
 
     /**
      * Returns the X coordinate scaling element (m00) of the 3x3
-     * affine transformation matrix.
+     * affine transformation matrix. However, this return value cannot be used
+     * to determine the amount by which X-coordinate is stretched or contracted.
      * @return a double value that is the X coordinate of the scaling
      *  element of the affine transformation matrix.
      * @see #getMatrix
      * @since 1.2
      */

@@ -1171,11 +1172,12 @@
         return m00;
     }
 
     /**
      * Returns the Y coordinate scaling element (m11) of the 3x3
-     * affine transformation matrix.
+     * affine transformation matrix. However, this return value cannot be used
+     * to determine the amount by which Y-coordinate is stretched or contracted.
      * @return a double value that is the Y coordinate of the scaling
      *  element of the affine transformation matrix.
      * @see #getMatrix
      * @since 1.2
      */