Added JSDocs

Author: photonstorm

src/curves/Curve.js

@@ -489,17 +489,16 @@ var Curve = new Class({
         return this.getTangent(t, out);
     },
 
-    //  Given a distance in pixels, get a t to find p.
     /**
-     * [description]
+     * Given a distance in pixels, get a t to find p.
      *
      * @method Phaser.Curves.Curve#getTFromDistance
      * @since 3.0.0
      *
-     * @param {integer} distance - [description]
-     * @param {integer} [divisions] - [description]
+     * @param {integer} distance - The distance, in pixels.
+     * @param {integer} [divisions] - Optional amount of divisions.
      *
-     * @return {number} [description]
+     * @return {number} The distance.
      */
     getTFromDistance: function (distance, divisions)
     {
@@ -511,19 +510,17 @@ var Curve = new Class({
         return this.getUtoTmapping(0, distance, divisions);
     },
 
-    // Given u ( 0 .. 1 ), get a t to find p. This gives you points which are equidistant
-
     /**
-     * [description]
+     * Given u ( 0 .. 1 ), get a t to find p. This gives you points which are equidistant.
      *
      * @method Phaser.Curves.Curve#getUtoTmapping
      * @since 3.0.0
      *
-     * @param {number} u - [description]
-     * @param {integer} distance - [description]
-     * @param {integer} [divisions] - [description]
+     * @param {number} u - A float between 0 and 1.
+     * @param {integer} distance - The distance, in pixels.
+     * @param {integer} [divisions] - Optional amount of divisions.
      *
-     * @return {number} [description]
+     * @return {number} The equidistant value.
      */
     getUtoTmapping: function (u, distance, divisions)
     {

src/curves/EllipseCurve.js

@@ -160,14 +160,14 @@ var EllipseCurve = new Class({
     },
 
     /**
-     * [description]
+     * Get the resolution of the curve.
      *
      * @method Phaser.Curves.Ellipse#getResolution
      * @since 3.0.0
      *
-     * @param {number} divisions - [description]
+     * @param {number} divisions - Optional divisions value.
      *
-     * @return {number} [description]
+     * @return {number} The curve resolution.
      */
     getResolution: function (divisions)
     {

src/curves/LineCurve.js

@@ -194,19 +194,17 @@ var LineCurve = new Class({
         return tangent.normalize();
     },
 
-    //  Override default Curve.getUtoTmapping
-
     /**
-     * [description]
+     * Given u ( 0 .. 1 ), get a t to find p. This gives you points which are equidistant.
      *
      * @method Phaser.Curves.Line#getUtoTmapping
      * @since 3.0.0
      *
-     * @param {number} u - [description]
-     * @param {integer} distance - [description]
-     * @param {integer} [divisions] - [description]
+     * @param {number} u - A float between 0 and 1.
+     * @param {integer} distance - The distance, in pixels.
+     * @param {integer} [divisions] - Optional amount of divisions.
      *
-     * @return {number} [description]
+     * @return {number} The equidistant value.
      */
     getUtoTmapping: function (u, distance, divisions)
     {

src/curves/QuadraticBezierCurve.js

@@ -11,7 +11,7 @@ var Vector2 = require('../math/Vector2');
 
 /**
  * @classdesc
- * [description]
+ * A quadratic Bézier curve constructed from two control points.
  *
  * @class QuadraticBezier
  * @extends Phaser.Curves.Curve
@@ -41,7 +41,7 @@ var QuadraticBezier = new Class({
         }
 
         /**
-         * [description]
+         * The start point.
          *
          * @name Phaser.Curves.QuadraticBezier#p0
          * @type {Phaser.Math.Vector2}
@@ -50,7 +50,7 @@ var QuadraticBezier = new Class({
         this.p0 = p0;
 
         /**
-         * [description]
+         * The first control point.
          *
          * @name Phaser.Curves.QuadraticBezier#p1
          * @type {Phaser.Math.Vector2}
@@ -59,7 +59,7 @@ var QuadraticBezier = new Class({
         this.p1 = p1;
 
         /**
-         * [description]
+         * The second control point.
          *
          * @name Phaser.Curves.QuadraticBezier#p2
          * @type {Phaser.Math.Vector2}
@@ -88,14 +88,14 @@ var QuadraticBezier = new Class({
     },
 
     /**
-     * [description]
+     * Get the resolution of the curve.
      *
      * @method Phaser.Curves.QuadraticBezier#getResolution
      * @since 3.2.0
      *
-     * @param {number} divisions - [description]
+     * @param {number} divisions - Optional divisions value.
      *
-     * @return {number} [description]
+     * @return {number} The curve resolution.
      */
     getResolution: function (divisions)
     {
@@ -130,7 +130,10 @@ var QuadraticBezier = new Class({
     },
 
     /**
-     * [description]
+     * Draws this curve on the given Graphics object.
+     *
+     * The curve is drawn using `Graphics.strokePoints` so will be drawn at whatever the present Graphics stroke color is.
+     * The Graphics object is not cleared before the draw, so the curve will appear on-top of anything else already rendered to it.
      *
      * @method Phaser.Curves.QuadraticBezier#draw
      * @since 3.2.0

src/curves/SplineCurve.js

@@ -128,14 +128,14 @@ var SplineCurve = new Class({
     },
 
     /**
-     * [description]
+     * Get the resolution of the curve.
      *
      * @method Phaser.Curves.Spline#getResolution
      * @since 3.0.0
      *
-     * @param {number} divisions - [description]
+     * @param {number} divisions - Optional divisions value.
      *
-     * @return {number} [description]
+     * @return {number} The curve resolution.
      */
     getResolution: function (divisions)
     {