Added jsdocs.

Author: photonstorm

src/geom/circle/Circle.js

@@ -9,7 +9,11 @@ var Circle = new Class({
     initialize:
 
     /**
-     * [description]
+     * A Circle object.
+     *
+     * This is a geometry object, containing numerical values and related methods to inspect and modify them.
+     * It is not a Game Object, in that you cannot add it to the display list, and it has no texture.
+     * To render a Circle you should look at the capabilities of the Graphics class.
      *
      * @class Circle
      * @memberOf Phaser.Geom

src/geom/ellipse/Area.js

@@ -1,12 +1,12 @@
 /**
- * [description]
+ * Calculates the area of the Ellipse.
  *
  * @function Phaser.Geom.Ellipse.Area
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} ellipse - [description]
+ * @param {Phaser.Geom.Ellipse} ellipse - The Ellipse to get the area of.
  *
- * @return {number} [description]
+ * @return {number} The area of the Ellipse.
  */
 var Area = function (ellipse)
 {

src/geom/ellipse/Circumference.js

@@ -1,12 +1,12 @@
 /**
- * [description]
+ * Returns the circumference of the given Ellipse.
  *
  * @function Phaser.Geom.Ellipse.Circumference
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} ellipse - [description]
+ * @param {Phaser.Geom.Ellipse} ellipse - The Ellipse to get the circumference of.
  *
- * @return {number} [description]
+ * @return {number} The circumference of th Ellipse.
  */
 var Circumference = function (ellipse)
 {

src/geom/ellipse/CircumferencePoint.js

@@ -1,17 +1,16 @@
 var Point = require('../point/Point');
 
 /**
- * Given an angle this will return a Point object containing the coordinates of the point
- * on the circumference of the ellipse.
+ * Returns a Point object containing the coordinates of a point on the circumference of the Ellipse based on the given angle.
  *
  * @function Phaser.Geom.Ellipse.CircumferencePoint
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} ellipse - [description]
- * @param {float} angle - [description]
- * @param {Phaser.Geom.Point|object} [out] - [description]
+ * @param {Phaser.Geom.Ellipse} ellipse - The Ellipse to get the circumference point on.
+ * @param {number} angle - The angle from the center of the Ellipse to the circumference to return the point from. Given in radians.
+ * @param {Phaser.Geom.Point|object} [out] - A Point, or point-like object, to store the results in. If not given a Point will be created.
  *
- * @return {Phaser.Geom.Point|object} [description]
+ * @return {Phaser.Geom.Point|object} A Point object where the `x` and `y` properties are the point on the circumference.
  */
 var CircumferencePoint = function (ellipse, angle, out)
 {

src/geom/ellipse/Clone.js

@@ -1,14 +1,14 @@
 var Ellipse = require('./Ellipse');
 
 /**
- * [description]
+ * Creates a new Ellipse instance based on the values contained in the given source.
  *
  * @function Phaser.Geom.Ellipse.Clone
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} source - [description]
+ * @param {Phaser.Geom.Ellipse} source - The Ellipse to be cloned. Can be an instance of an Ellipse or a ellipse-like object, with x, y, width and height properties.
  *
- * @return {Phaser.Geom.Ellipse} [description]
+ * @return {Phaser.Geom.Ellipse} A clone of the source Ellipse.
  */
 var Clone = function (source)
 {

src/geom/ellipse/Contains.js

@@ -1,14 +1,14 @@
 /**
- * [description]
+ * Check to see if the Ellipse contains the given x / y coordinates.
  *
  * @function Phaser.Geom.Ellipse.Contains
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} ellipse - [description]
- * @param {number} x - [description]
- * @param {number} y - [description]
+ * @param {Phaser.Geom.Ellipse} ellipse - The Ellipse to check.
+ * @param {number} x - The x coordinate to check within the ellipse.
+ * @param {number} y - The y coordinate to check within the ellipse.
  *
- * @return {boolean} [description]
+ * @return {boolean} True if the coordinates are within the ellipse, otherwise false.
  */
 var Contains = function (ellipse, x, y)
 {

src/geom/ellipse/ContainsPoint.js

@@ -1,15 +1,15 @@
 var Contains = require('./Contains');
 
 /**
- * [description]
+ * Check to see if the Ellipse contains the given Point object.
  *
  * @function Phaser.Geom.Ellipse.ContainsPoint
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} ellipse - [description]
- * @param {Phaser.Geom.Point|object} point - [description]
+ * @param {Phaser.Geom.Ellipse} ellipse - The Ellipse to check.
+ * @param {Phaser.Geom.Point|object} point - The Point object to check if it's within the Circle or not.
  *
- * @return {boolean} [description]
+ * @return {boolean} True if the Point coordinates are within the circle, otherwise false.
  */
 var ContainsPoint = function (ellipse, point)
 {

src/geom/ellipse/ContainsRect.js

@@ -1,15 +1,15 @@
 var Contains = require('./Contains');
 
 /**
- * [description]
+ * Check to see if the Ellipse contains all four points of the given Rectangle object.
  *
  * @function Phaser.Geom.Ellipse.ContainsRect
  * @since 3.0.0
  *
  * @param {Phaser.Geom.Ellipse} ellipse - [description]
- * @param {Phaser.Geom.Rectangle|object} rect - [description]
+ * @param {Phaser.Geom.Rectangle|object} rect - The Rectangle object to check if it's within the Ellipse or not.
  *
- * @return {boolean} [description]
+ * @return {boolean} True if all of the Rectangle coordinates are within the ellipse, otherwise false.
  */
 var ContainsRect = function (ellipse, rect)
 {

src/geom/ellipse/CopyFrom.js

@@ -1,13 +1,14 @@
 /**
- * [description]
+ * Copies the `x`, `y`, `width` and `height` properties from the `source` Ellipse
+ * into the given `dest` Ellipse, then returns the `dest` Ellipse.
  *
  * @function Phaser.Geom.Ellipse.CopyFrom
  * @since 3.0.0
  *
- * @param {Phaser.Geom.Ellipse} source - [description]
- * @param {Phaser.Geom.Ellipse} dest - [description]
+ * @param {Phaser.Geom.Ellipse} source - The source Ellipse to copy the values from.
+ * @param {Phaser.Geom.Ellipse} dest - The destination Ellipse to copy the values to.
  *
- * @return {Phaser.Geom.Ellipse} [description]
+ * @return {Phaser.Geom.Ellipse} The dest Ellipse.
  */
 var CopyFrom = function (source, dest)
 {