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

@@ -4,42 +4,50 @@
 
 
 /**
- * Draws features on a vector layer when active.
- * 
- * @class
  * @requires OpenLayers/Control.js
  * @requires OpenLayers/Feature/Vector.js
+ *
+ * Class: OpenLayers.Control.DrawFeature
+ * Draws features on a vector layer when active.
+ *
+ * Inherits from:
+ *  - <OpenLayers.Control>
  */
 OpenLayers.Control.DrawFeature = OpenLayers.Class.create();
 OpenLayers.Control.DrawFeature.prototype = 
   OpenLayers.Class.inherit(OpenLayers.Control, {
     
     /**
-     * @type OpenLayers.Layer.Vector
+     * Property: layer
+     * {<OpenLayers.Layer.Vector>}
      */
     layer: null,
 
     /**
-     * @type {Object} The functions that are sent to the handler for callback
+     * Property: callbacks
+     * {Object} The functions that are sent to the handler for callback
      */
     callbacks: null,
     
     /**
-     * @type {Function} Called after each feature is added
+     * APIProperty: featureAdded
+     * {Function} Called after each feature is added
      */
     featureAdded: function() {},
 
     /**
-     * Used to set non-default properties on the control's handler
-     *
-     * @type Object
+     * APIProperty: handlerOptions
+     * {Object} Used to set non-default properties on the control's handler
      */
     handlerOptions: null,
     
     /**
-     * @param {OpenLayers.Layer.Vector} layer
-     * @param {OpenLayers.Handler} handler
-     * @param {Object} options
+     * Constructor: OpenLayers.Control.DrawFeature
+     * 
+     * Parameters:
+     * layer - {<OpenLayers.Layer.Vector>} 
+     * handler - {<OpenLayers.Handler>} 
+     * options - {Object} 
      */
     initialize: function(layer, handler, options) {
         OpenLayers.Control.prototype.initialize.apply(this, [options]);
@@ -50,7 +58,7 @@ OpenLayers.Control.DrawFeature.prototype =
     },
 
     /**
-     *
+     * Method: drawFeature
      */
     drawFeature: function(geometry) {
         var feature = new OpenLayers.Feature.Vector(geometry);