Added jsdocs

Author: photonstorm

src/dom/ScaleManager.js

@@ -12,7 +12,7 @@ var Rectangle = require('../geom/rectangle/Rectangle');
 
 /**
  * @classdesc
- * [description]
+ * TODO
  *
  * @class ScaleManager
  * @memberof Phaser.DOM

src/dom/_ScaleManager.js

@@ -17,7 +17,7 @@ var VisualBounds = require('./VisualBounds');
 
 /**
  * @classdesc
- * [description]
+ * TODO
  *
  * @class ScaleManager
  * @memberof Phaser.DOM

src/gameobjects/graphics/Graphics.js

@@ -1013,7 +1013,7 @@ var Graphics = new Class({
      * @param {number} x - The x coordinate to draw the line to.
      * @param {number} y - The y coordinate to draw the line to.
      * @param {number} width - The width of the stroke.
-     * @param {number} rgb - [description]
+     * @param {number} rgb - The color of the stroke.
      *
      * @return {Phaser.GameObjects.Graphics} This Game Object.
      */
@@ -1036,7 +1036,7 @@ var Graphics = new Class({
      * @param {number} x - The x coordinate to move to.
      * @param {number} y - The y coordinate to move to.
      * @param {number} width - The new stroke width.
-     * @param {number} rgb - [description]
+     * @param {number} rgb - The new stroke color.
      *
      * @return {Phaser.GameObjects.Graphics} This Game Object.
      */

src/gameobjects/particles/EmitterOp.js

@@ -78,14 +78,14 @@ var Wrap = require('../../math/Wrap');
 /**
  * @typedef {object} EmitterOpCustomEmitConfig
  *
- * @property {EmitterOpOnEmitCallback} onEmit - [description]
+ * @property {EmitterOpOnEmitCallback} onEmit - A callback that is invoked each time the emitter emits a particle.
  */
 
 /**
  * @typedef {object} EmitterOpCustomUpdateConfig
  *
- * @property {EmitterOpOnEmitCallback} [onEmit] - [description]
- * @property {EmitterOpOnUpdateCallback} onUpdate - [description]
+ * @property {EmitterOpOnEmitCallback} [onEmit] - A callback that is invoked each time the emitter emits a particle.
+ * @property {EmitterOpOnUpdateCallback} onUpdate - A callback that is invoked each time the emitter updates.
  */
 
 /**

src/gameobjects/particles/GravityWell.js

@@ -19,7 +19,11 @@ var GetFastValue = require('../../utils/object/GetFastValue');
 
 /**
  * @classdesc
- * [description]
+ * The GravityWell action applies a force on the particle to draw it towards, or repel it from, a single point.
+ * 
+ * The force applied is inversely proportional to the square of the distance from the particle to the point, in accordance with Newton's law of gravity.
+ * 
+ * This simulates the effect of gravity over large distances (as between planets, for example).
  *
  * @class GravityWell
  * @memberof Phaser.GameObjects.Particles
@@ -28,8 +32,8 @@ var GetFastValue = require('../../utils/object/GetFastValue');
  *
  * @param {(number|GravityWellConfig)} [x=0] - The x coordinate of the Gravity Well, in world space.
  * @param {number} [y=0] - The y coordinate of the Gravity Well, in world space.
- * @param {number} [power=0] - The power of the Gravity Well.
- * @param {number} [epsilon=100] - [description]
+ * @param {number} [power=0] - The strength of the gravity force - larger numbers produce a stronger force.
+ * @param {number} [epsilon=100] - The minimum distance for which the gravity force is calculated.
  * @param {number} [gravity=50] - The gravitational force of this Gravity Well.
  */
 var GravityWell = new Class({
@@ -118,7 +122,7 @@ var GravityWell = new Class({
         this._epsilon = 0;
 
         /**
-         * The power of the Gravity Well.
+         * The strength of the gravity force - larger numbers produce a stronger force.
          *
          * @name Phaser.GameObjects.Particles.GravityWell#power
          * @type {number}
@@ -127,7 +131,7 @@ var GravityWell = new Class({
         this.power = power;
 
         /**
-         * [description]
+         * The minimum distance for which the gravity force is calculated.
          *
          * @name Phaser.GameObjects.Particles.GravityWell#epsilon
          * @type {number}

src/physics/arcade/tilemap/SeparateTile.js

@@ -17,7 +17,7 @@ var TileIntersectsBody = require('./TileIntersectsBody');
  * @param {number} i - The index of the tile within the map data.
  * @param {Phaser.Physics.Arcade.Body} body - The Body object to separate.
  * @param {Phaser.Tilemaps.Tile} tile - The tile to collide against.
- * @param {Phaser.Geom.Rectangle} tileWorldRect - [description]
+ * @param {Phaser.Geom.Rectangle} tileWorldRect - A rectangle-like object defining the dimensions of the tile.
  * @param {(Phaser.Tilemaps.DynamicTilemapLayer|Phaser.Tilemaps.StaticTilemapLayer)} tilemapLayer - The tilemapLayer to collide against.
  * @param {number} tileBias - The tile bias value. Populated by the `World.TILE_BIAS` constant.
  *