better API doc strings in the Kinetic class, no functional change

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

lib/OpenLayers/Kinetic.js

@@ -63,7 +63,6 @@ OpenLayers.Kinetic = OpenLayers.Class({
 
     /**
      * Method: begin
-     *
      * Begins the dragging.
      */
     begin: function() {
@@ -74,8 +73,10 @@ OpenLayers.Kinetic = OpenLayers.Class({
 
     /**
      * Method: update
-     *
      * Updates during the dragging.
+     *
+     * Parameters:
+     * xy - {<OpenLayers.Pixel>} The new position.
      */
     update: function(xy) {
         this.points.unshift({xy: xy, tick: new Date().getTime()});
@@ -86,8 +87,15 @@ OpenLayers.Kinetic = OpenLayers.Class({
 
     /**
      * Method: end
-     *
      * Ends the dragging, start the kinetic.
+     *
+     * Parameters:
+     * xy - {<OpenLayers.Pixel>} The last position.
+     *
+     * Returns:
+     * {Object} An object with two properties: "speed", and "theta". The
+     *     "speed" and "theta" values are to be passed to the move 
+     *     function when starting the animation.
      */
     end: function(xy) {
         var last, now = new Date().getTime();
@@ -117,12 +125,13 @@ OpenLayers.Kinetic = OpenLayers.Class({
 
     /**
      * Method: move
-     *
      * Launch the kinetic move pan.
      *
      * Parameters:
-     * info - {Object}
-     * callback - arguments x, y (values to pan), end (is the last point)
+     * info - {Object} An object with two properties, "speed", and "theta".
+     *     These values are those returned from the "end" call.
+     * callback - {Function} Function called on every step of the animation,
+     *     receives x, y (values to pan), end (is the last point).
      */
     move: function(info, callback) {
         var v0 = info.speed;