diff --git a/src/java.desktop/share/classes/java/awt/Rectangle.java b/src/java.desktop/share/classes/java/awt/Rectangle.java
index ecc531c1473..3ebd3fb3edc 100644
--- a/src/java.desktop/share/classes/java/awt/Rectangle.java
+++ b/src/java.desktop/share/classes/java/awt/Rectangle.java
@@ -922,7 +922,7 @@ public class Rectangle extends Rectangle2D
      * If the specified point must be contained within the new
      * {@code Rectangle}, a 1x1 rectangle should be added instead:
      * <pre>
-     *     r.add(newx, newy, 1, 1);
+     *     r.add(new Rectangle(newx, newy, 1, 1));
      * </pre>
      * @param newx the X coordinate of the new point
      * @param newy the Y coordinate of the new point
@@ -973,7 +973,7 @@ public class Rectangle extends Rectangle2D
      * If the specified point must be contained within the new
      * {@code Rectangle}, a 1x1 rectangle should be added instead:
      * <pre>
-     *     r.add(pt.x, pt.y, 1, 1);
+     *     r.add(new Rectangle(pt, new Dimension(1, 1)));
      * </pre>
      * @param pt the new {@code Point} to add to this
      *           {@code Rectangle}