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.js

@@ -6,9 +6,6 @@
  * @requires OpenLayers/BaseTypes.js
  */ 
 
-////
-/// This blob sucks in all the files in uncompressed form for ease of use
-///
 (function() {
     /**
      * Before creating the OpenLayers namespace, check to see if
@@ -17,22 +14,25 @@
      * case with single file builds.
      */
     var singleFile = (typeof OpenLayers == "object" && OpenLayers.singleFile);
+    
     /**
+     * Namespace: OpenLayers
      * The OpenLayers object provides a namespace for all things OpenLayers
-     * @type Object
      */
     OpenLayers = {
         
         /**
-         * @type String
-         * @private
+         * Property: _scriptName
+         * {String} Relative path of this script.
          */
         _scriptName: (!singleFile) ? "lib/OpenLayers.js" : "OpenLayers.js",
 
         /**
-         * @type String
-         * @returns Path to this script
-         * @private
+         * Function: _getScriptLocation
+         * Return the path to this script.
+         *
+         * Return:
+         * Path to this script
          */
         _getScriptLocation: function () {
             var scriptLocation = "";
@@ -184,4 +184,8 @@
         if (allScriptTags) document.write(allScriptTags);
     }
 })();
+
+/**
+ * Constant: VERSION_NUMBER
+ */
 OpenLayers.VERSION_NUMBER="$Revision$";