Separating jsdoc style docs into their own block. The new NaturalDocs doesn't parse these mixed blocks, giving us no class descriptions with the two together. (closes #1229)

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

lib/OpenLayers/Handler/Box.js

@@ -5,7 +5,9 @@
 /**
  * @requires OpenLayers/Handler.js
  * @requires OpenLayers/Handler/Drag.js
- * 
+ */
+
+/**
  * Class: OpenLayers.Handler.Box
  * Handler for dragging a rectangle across the map.  Box is displayed 
  * on mouse down, moves on mouse move, and is finished on mouse up.

lib/OpenLayers/Handler/Click.js

@@ -4,7 +4,9 @@
 
 /**
  * @requires OpenLayers/Handler.js
- *
+ */
+
+/**
  * Class: OpenLayers.Handler.Click
  * A handler for mouse clicks.  The intention of this handler is to give
  *     controls more flexibility with handling clicks.  Browsers trigger

lib/OpenLayers/Handler/Drag.js

@@ -4,7 +4,9 @@
 
 /**
  * @requires OpenLayers/Handler.js
- * 
+ */
+
+/**
  * Class: OpenLayers.Handler.Drag
  * The drag handler is used to deal with sequences of browser events related
  *     to dragging.  The handler is used by controls that want to know when

lib/OpenLayers/Handler/Feature.js

@@ -5,7 +5,9 @@
 
 /**
  * @requires OpenLayers/Handler.js
- * 
+ */
+
+/**
  * Class: OpenLayers.Handler.Feature 
  * Handler to respond to mouse events related to a drawn feature.  Callbacks
  *     with the following keys will be notified of the following events

lib/OpenLayers/Handler/Keyboard.js

@@ -5,7 +5,9 @@
 /**
  * @requires OpenLayers/Handler.js
  * @requires OpenLayers/Events.js
- *
+ */
+
+/**
  * Class: OpenLayers.handler.Keyboard
  * A handler for keyboard events.  Create a new instance with the
  *     <OpenLayers.Handler.Keyboard> constructor.

lib/OpenLayers/Handler/MouseWheel.js

@@ -4,7 +4,9 @@
 
 /**
  * @requires OpenLayers/Handler.js
- *
+ */
+
+/**
  * Class: OpenLayers.Handler.MouseWheel
  * Handler for wheel up/down events.
  * 

lib/OpenLayers/Handler/Path.js

@@ -7,7 +7,9 @@
  * @requires OpenLayers/Handler/Point.js
  * @requires OpenLayers/Geometry/Point.js
  * @requires OpenLayers/Geometry/LineString.js
- *
+ */
+
+/**
  * Class: OpenLayers.Handler.Path
  * Handler to draw a path on the map.  Path is displayed on mouse down,
  * moves on mouse move, and is finished on mouse up.

lib/OpenLayers/Handler/Point.js

@@ -6,7 +6,9 @@
 /**
  * @requires OpenLayers/Handler.js
  * @requires OpenLayers/Geometry/Point.js
- * 
+ */
+
+/**
  * Class: OpenLayers.Handler.Point
  * Handler to draw a point on the map.  Point is displayed on mouse down,
  * moves on mouse move, and is finished on mouse up.  The handler triggers

lib/OpenLayers/Handler/Polygon.js

@@ -6,7 +6,9 @@
 /**
  * @requires OpenLayers/Handler/Path.js
  * @requires OpenLayers/Geometry/Polygon.js
- *
+ */
+
+/**
  * Class: OpenLayers.Handler.Polygon
  * Handler to draw a polygon on the map.  Polygon is displayed on mouse down,
  * moves on mouse move, and is finished on mouse up.

lib/OpenLayers/Handler/RegularPolygon.js

@@ -5,7 +5,9 @@
 
 /**
  * @requires OpenLayers/Handler/Drag.js
- * 
+ */
+
+/**
  * Class: OpenLayers.Handler.RegularPolygon
  * Handler to draw a regular polygon on the map.  Polygon is displayed on mouse
  *     down, moves or is modified on mouse move, and is finished on mouse up.