From 8239a5c92a22903947709f95f701e607de7b0f3d Mon Sep 17 00:00:00 2001
From: Frederic Junod <frederic.junod@camptocamp.com>
Date: Tue, 20 May 2014 14:15:28 +0200
Subject: [PATCH] Document ol.coordinate functions

---
 src/ol/coordinate.js | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/src/ol/coordinate.js b/src/ol/coordinate.js
index 3d262a2413..8c8dc35808 100644
--- a/src/ol/coordinate.js
+++ b/src/ol/coordinate.js
@@ -33,6 +33,9 @@ ol.CoordinateArray;
 
 
 /**
+ * Add `delta` to `coordinate`. `coordinate` is modified in place and returned
+ * by the function.
+ *
  * @param {ol.Coordinate} coordinate Coordinate.
  * @param {ol.Coordinate} delta Delta.
  * @return {ol.Coordinate} Coordinate.
@@ -156,8 +159,11 @@ ol.coordinate.equals = function(coordinate1, coordinate2) {
 
 
 /**
+ * Rotate `coordinate` by `angle`. `coordinate` is modified in place and
+ * returned by the function.
+ *
  * @param {ol.Coordinate} coordinate Coordinate.
- * @param {number} angle Angle.
+ * @param {number} angle Angle in radian.
  * @return {ol.Coordinate} Coordinate.
  * @todo api
  */
@@ -173,18 +179,24 @@ ol.coordinate.rotate = function(coordinate, angle) {
 
 
 /**
+ * Scale `coordinate` by `scale`. `coordinate` is modified in place and returned
+ * by the function.
+ *
  * @param {ol.Coordinate} coordinate Coordinate.
- * @param {number} s Scale.
+ * @param {number} scale Scale factor.
  * @return {ol.Coordinate} Coordinate.
  */
-ol.coordinate.scale = function(coordinate, s) {
-  coordinate[0] *= s;
-  coordinate[1] *= s;
+ol.coordinate.scale = function(coordinate, scale) {
+  coordinate[0] *= scale;
+  coordinate[1] *= scale;
   return coordinate;
 };
 
 
 /**
+ * Subtract `delta` to `coordinate`. `coordinate` is modified in place and
+ * returned by the function.
+ *
  * @param {ol.Coordinate} coordinate Coordinate.
  * @param {ol.Coordinate} delta Delta.
  * @return {ol.Coordinate} Coordinate.