#794 - adding resolutions as a property of OpenLayers.Map - adding additional comments for ND as well - we need to revisit APIProperties on Layer and Map

git-svn-id: http://svn.openlayers.org/trunk/openlayers@3568 dc9f47b5-9b13-0410-9fdd-eb0c1a62fdaf

lib/OpenLayers/Layer.js

@@ -100,12 +100,14 @@ OpenLayers.Layer.prototype = {
 
     /** 
      * Property: options
-     * {Object} 
+     * {Object} An optional object whose properties will be set on the layer.
+     * Any of the layer properties can be set as a property of the options
+     * object and sent to the constructor when the layer is created.
      */
     options: null,
 
     /**
-     * Property: gutter
+     * APIProperty: gutter
      * {Integer} Determines the width (in pixels) of the gutter around image
      *           tiles to ignore.  By setting this property to a non-zero 
      *           value, images will be requested that are wider and taller 
@@ -118,7 +120,7 @@ OpenLayers.Layer.prototype = {
     gutter: 0, 
 
     /**
-     * Property: projection
+     * APIProperty: projection
      * {String} Set in the layer options to override the default projection
      *          string this layer - also set maxExtent, maxResolution, and 
      *          units if appropriate.
@@ -126,38 +128,41 @@ OpenLayers.Layer.prototype = {
     projection: null,    
     
     /**
-     * Property: units
+     * APIProperty: units
      * {String} The layer map units.  Defaults to 'degrees'.  Possible values
      *          are 'degrees' (or 'dd'), 'm', 'ft', 'km', 'mi', 'inches'.
      */
     units: null,
 
     /**
-     * Property: scales
+     * APIProperty: scales
      * {Array}
      */
     scales: null,
 
     /**
-     * Property: resolutions
-     * {Array}
+     * APIProperty: resolutions
+     * {Array} A list of map resolutions (map units per pixel) in descending
+     * order.  If this is not set in the layer constructor, it will be set
+     * based on other resolution related properties (maxExtent, maxResolution,
+     * maxScale, etc.).
      */
     resolutions: null,
     
     /**
-     * Property: maxExtent
+     * APIProperty: maxExtent
      * {<OpenLayers.Bounds>}
      */
     maxExtent: null,
     
     /**
-     * Property: minExtent
+     * APIProperty: minExtent
      * {<OpenLayers.Bounds>}
      */
     minExtent: null,
     
     /**
-     * Property: maxResolution
+     * APIProperty: maxResolution
      * {Float} Default max is 360 deg / 256 px, which corresponds to
      *         zoom level 0 on gmaps.  Specify a different value in the layer 
      *         options if you are not using a geographic projection and 
@@ -166,38 +171,38 @@ OpenLayers.Layer.prototype = {
     maxResolution: null,
 
     /**
-     * Property: minResolution
+     * APIProperty: minResolution
      * {Float}
      */
     minResolution: null,
 
     /**
-     * Property: numZoomLevels
+     * APIProperty: numZoomLevels
      * {Integer}
      */
     numZoomLevels: null,
    
     /**
-     * Property: minScale
+     * APIProperty: minScale
      * {Float}
      */
     minScale: null,
     
     /**
-     * Property: maxScale
+     * APIProperty: maxScale
      * {Float}
      */
     maxScale: null,
 
     /**
-     * Property: displayOutsideMaxExtent
+     * APIProperty: displayOutsideMaxExtent
      * {Boolean} Request map tiles that are completely outside of the max extent
      *           for this layer.  Defaults to false
      */
     displayOutsideMaxExtent: false,
 
     /**
-     * Property: wrapDateLine
+     * APIProperty: wrapDateLine
      * {Boolean} #487 for more info.   
      */
     wrapDateLine: false,