Added lots of missing jsdocs

Author: photonstorm

src/physics/arcade/Collider.js

@@ -8,15 +8,16 @@ var Class = require('../../utils/Class');
 
 /**
  * @classdesc
- * The Collider class checks for collision between objects every frame
+ * An Arcade Physics Collider will automatically check for collision, or overlaps, between two objects
+ * every step. If a collision, or overlap, occurs it will invoke the given callbacks.
  *
  * @class Collider
  * @memberof Phaser.Physics.Arcade
  * @constructor
  * @since 3.0.0
  *
  * @param {Phaser.Physics.Arcade.World} world - The Arcade physics World that will manage the collisions.
- * @param {boolean} overlapOnly - Wether to check for collisions or overlap.
+ * @param {boolean} overlapOnly - Whether to check for collisions or overlap.
  * @param {ArcadeColliderType} object1 - The first object to check for collision.
  * @param {ArcadeColliderType} object2 - The second object to check for collision.
  * @param {ArcadePhysicsCallback} collideCallback - The callback to invoke when the two objects collide.
@@ -48,7 +49,7 @@ var Collider = new Class({
         this.name = '';
 
         /**
-         * Wether the collider is active.
+         * Whether the collider is active.
          *
          * @name Phaser.Physics.Arcade.Collider#active
          * @type {boolean}
@@ -58,7 +59,7 @@ var Collider = new Class({
         this.active = true;
 
         /**
-         * Wether to check for collisions or overlaps.
+         * Whether to check for collisions or overlaps.
          *
          * @name Phaser.Physics.Arcade.Collider#overlapOnly
          * @type {boolean}
@@ -113,14 +114,16 @@ var Collider = new Class({
     },
 
     /**
-     * A name for the Collider ( currently unused internally by phaser ).
+     * A name for the Collider.
+     * 
+     * Phaser does not use this value, it's for your own reference.
      *
      * @method Phaser.Physics.Arcade.Collider#setName
      * @since 3.1.0
      *
      * @param {string} name - The name to assign to the Collider.
      *
-     * @return {Phaser.Physics.Arcade.Collider} [description]
+     * @return {Phaser.Physics.Arcade.Collider} This Collider instance.
      */
     setName: function (name)
     {

src/physics/arcade/GetOverlapX.js

@@ -7,7 +7,8 @@
 var CONST = require('./const');
 
 /**
- * Calculates and returns the horizontal overlap between two arcade physics bodies and set their properties accordingly,including:`touching.left`,`touching.right`,`touching.none` and `overlapX'.
+ * Calculates and returns the horizontal overlap between two arcade physics bodies and sets their properties
+ * accordingly, including: `touching.left`, `touching.right`, `touching.none` and `overlapX'.
  *
  * @function Phaser.Physics.Arcade.GetOverlapX
  * @since 3.0.0
@@ -17,7 +18,7 @@ var CONST = require('./const');
  * @param {boolean} overlapOnly - Is this an overlap only check, or part of separation?
  * @param {number} bias - A value added to the delta values during collision checks. Increase it to prevent sprite tunneling(sprites passing through another instead of colliding).
  *
- * @return {number} [description]
+ * @return {number} The amount of overlap.
  */
 var GetOverlapX = function (body1, body2, overlapOnly, bias)
 {

src/physics/arcade/GetOverlapY.js

@@ -7,17 +7,18 @@
 var CONST = require('./const');
 
 /**
- * [description]
+ * Calculates and returns the vertical overlap between two arcade physics bodies and sets their properties
+ * accordingly, including: `touching.up`, `touching.down`, `touching.none` and `overlapY'.
  *
  * @function Phaser.Physics.Arcade.GetOverlapY
  * @since 3.0.0
  *
- * @param {Phaser.Physics.Arcade.Body} body1 - [description]
- * @param {Phaser.Physics.Arcade.Body} body2 - [description]
- * @param {boolean} overlapOnly - [description]
- * @param {number} bias - [description]
+ * @param {Phaser.Physics.Arcade.Body} body1 - The first Body to separate.
+ * @param {Phaser.Physics.Arcade.Body} body2 - The second Body to separate.
+ * @param {boolean} overlapOnly - Is this an overlap only check, or part of separation?
+ * @param {number} bias - A value added to the delta values during collision checks. Increase it to prevent sprite tunneling(sprites passing through another instead of colliding).
  *
- * @return {number} [description]
+ * @return {number} The amount of overlap.
  */
 var GetOverlapY = function (body1, body2, overlapOnly, bias)
 {

src/physics/arcade/SeparateX.js

@@ -7,17 +7,21 @@
 var GetOverlapX = require('./GetOverlapX');
 
 /**
- * [description]
+ * Separates two overlapping bodies on the X-axis (horizontally).
+ *
+ * Separation involves moving two overlapping bodies so they don't overlap anymore and adjusting their velocities based on their mass. This is a core part of collision detection.
+ *
+ * The bodies won't be separated if there is no horizontal overlap between them, if they are static, or if either one uses custom logic for its separation.
  *
  * @function Phaser.Physics.Arcade.SeparateX
  * @since 3.0.0
  *
- * @param {Phaser.Physics.Arcade.Body} body1 - [description]
- * @param {Phaser.Physics.Arcade.Body} body2 - [description]
- * @param {boolean} overlapOnly - [description]
- * @param {number} bias - [description]
+ * @param {Phaser.Physics.Arcade.Body} body1 - The first Body to separate.
+ * @param {Phaser.Physics.Arcade.Body} body2 - The second Body to separate.
+ * @param {boolean} overlapOnly - If `true`, the bodies will only have their overlap data set and no separation will take place.
+ * @param {number} bias - A value to add to the delta value during overlap checking. Used to prevent sprite tunneling.
  *
- * @return {boolean} [description]
+ * @return {boolean} `true` if the two bodies overlap horizontally, otherwise `false`.
  */
 var SeparateX = function (body1, body2, overlapOnly, bias)
 {

src/physics/arcade/SeparateY.js

@@ -21,7 +21,7 @@ var GetOverlapY = require('./GetOverlapY');
  * @param {boolean} overlapOnly - If `true`, the bodies will only have their overlap data set and no separation will take place.
  * @param {number} bias - A value to add to the delta value during overlap checking. Used to prevent sprite tunneling.
  *
- * @return {boolean} `true` if the two bodies overlap vertically, `false` otherwise.
+ * @return {boolean} `true` if the two bodies overlap vertically, otherwise `false`.
  */
 var SeparateY = function (body1, body2, overlapOnly, bias)
 {

src/physics/arcade/StaticBody.js

@@ -751,7 +751,7 @@ var StaticBody = new Class({
     },
 
     /**
-     * [description]
+     * The change in this StaticBody's rotation from the previous step. Always zero.
      *
      * @method Phaser.Physics.Arcade.StaticBody#deltaZ
      * @since 3.0.0