Merge all changes from the naturaldocs sandbox. This brings all the work that

has been done in the NaturalDocs branch back to trunk. Thanks to everyone who
helped out in making this happen. (I could list people, but the list would
be long, and I'm already mentally on vacation.)


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

lib/OpenLayers/Control/ArgParser.js

@@ -1,38 +1,54 @@
-/* Copyright (c) 2006 MetaCarta, Inc., published under a modified BSD license.
+/* Cpyright (c) 2006 MetaCarta, Inc., published under a modified BSD license.
  * See http://svn.openlayers.org/trunk/openlayers/repository-license.txt 
  * for the full text of the license. */
 
 
 /**
- * @class
- * 
  * @requires OpenLayers/Control.js
+ *
+ * Class: OpenLayers.Control.ArgParser
+ * 
+ * Inherits from:
+ *  - <OpenLayers.Control>
  */
 OpenLayers.Control.ArgParser = OpenLayers.Class.create();
 OpenLayers.Control.ArgParser.prototype = 
   OpenLayers.Class.inherit( OpenLayers.Control, {
 
-    /** @type OpenLayers.LonLat */
+    /**
+     * Parameter: center
+     * {<OpenLayers.LonLat>}
+     */
     center: null,
     
-    /** @type int */
+    /**
+     * Parameter: zoom
+     * {int}
+     */
     zoom: null,
 
-    /** @type Array */
+    /**
+     * Parameter: layers 
+     * {Array}
+     */
     layers: null,
 
     /**
-     * @constructor
-     * 
-     * @param {Object} options
+     * Constructor: OpenLayers.Control.ArgParser
+     *
+     * Parameters:
+     * options - {Object}
      */
     initialize: function(options) {
         OpenLayers.Control.prototype.initialize.apply(this, arguments);
     },
 
-    /** Set the map property for the control. 
+    /**
+     * Method: setMap
+     * Set the map property for the control. 
      * 
-     * @param {OpenLayers.Map} map
+     * Parameters:
+     * map - {<OpenLayers.Map>} 
      */
     setMap: function(map) {
         OpenLayers.Control.prototype.setMap.apply(this, arguments);
@@ -72,7 +88,9 @@ OpenLayers.Control.ArgParser.prototype =
         }
     },
    
-    /** As soon as a baseLayer has been loaded, we center and zoom
+    /** 
+     * Method: setCenter
+     * As soon as a baseLayer has been loaded, we center and zoom
      *   ...and remove the handler.
      */
     setCenter: function() {
@@ -86,7 +104,9 @@ OpenLayers.Control.ArgParser.prototype =
         }
     },
 
-    /** As soon as all the layers are loaded, cycle through them and 
+    /** 
+     * Method: configureLayers
+     * As soon as all the layers are loaded, cycle through them and 
      *   hide or show them. 
      */
     configureLayers: function() {