diff --git a/lib/OpenLayers/Geometry/Rectangle.js b/lib/OpenLayers/Geometry/Rectangle.js
index 69a0047802..32972448cd 100644
--- a/lib/OpenLayers/Geometry/Rectangle.js
+++ b/lib/OpenLayers/Geometry/Rectangle.js
@@ -8,9 +8,12 @@
 
 /**
  * Class: OpenLayers.Geometry.Rectangle
- * A Rectangle is a simple geometry. It is specified by a point (x and y) 
- *     and dimensions (width and height), all of which are directly accessible 
- *     as properties.
+ * This class is *not supported*, and probably isn't what you're looking for.
+ *     Instead, most users probably want something like:
+ *     (code)
+ *     var poly = new OpenLayers.Bounds(0,0,10,10).toGeometry();
+ *     (end)
+ *     This will create a rectangular Polygon geometry. 
  * 
  * Inherits:
  *  - <OpenLayers.Geometry>