diff --git a/lib/OpenLayers/Map.js b/lib/OpenLayers/Map.js
index 3315494bf3..cb2163c867 100644
--- a/lib/OpenLayers/Map.js
+++ b/lib/OpenLayers/Map.js
@@ -299,11 +299,14 @@ OpenLayers.Map = OpenLayers.Class({
     /**
      * APIProperty: maxExtent
      * {<OpenLayers.Bounds>} The maximum extent for the map.  Defaults to the
-     *                       whole world in decimal degrees 
-     *                       (-180, -90, 180, 90).  Specify a different
-     *                        extent in the map options if you are not using a 
-     *                        geographic projection and displaying the whole 
-     *                        world.
+     *     whole world in decimal degrees 
+     *     (-180, -90, 180, 90).  Specify a different
+     *     extent in the map options if you are not using a 
+     *     geographic projection and displaying the whole 
+     *     world. To restrict user panning and
+     *     zooming of the map, use restrictedExtent instead.
+     *     The value for maxExtent will change calculations for
+     *     tile URLs.
      */
     maxExtent: null,