Fix for phaserjs#732 (Timer.onComplete not firing).

jsdoc updates across Math and InputHandler.

Author: photonstorm

src/core/Group.js

@@ -1422,7 +1422,7 @@ Phaser.Group.prototype.remove = function (child, destroy) {
 
     if (destroy && removed)
     {
-        removed.destroy();
+        removed.destroy(true);
     }
 
     return true;
@@ -1456,7 +1456,7 @@ Phaser.Group.prototype.removeAll = function (destroy) {
 
         if (destroy && removed)
         {
-            removed.destroy();
+            removed.destroy(true);
         }
     }
     while (this.children.length > 0);
@@ -1501,7 +1501,7 @@ Phaser.Group.prototype.removeBetween = function (startIndex, endIndex, destroy)
 
         if (destroy && removed)
         {
-            removed.destroy();
+            removed.destroy(true);
         }
 
         if (this.cursor === this.children[i])

src/input/InputHandler.js

@@ -29,7 +29,10 @@ Phaser.InputHandler = function (sprite) {
     this.enabled = false;
 
     /**
-    * @property {number} priorityID - The PriorityID controls which Sprite receives an Input event first if they should overlap.
+    * The priorityID is used to determine which game objects should get priority when input events occur. For example if you have
+    * several Sprites that overlap, by default the one at the top of the display list is given priority for input events. You can
+    * stop this from happening by controlling the priorityID value. The higher the value, the more important they are considered to the Input events.
+    * @property {number} priorityID
     * @default
     */
     this.priorityID = 0;

src/math/Math.js

@@ -769,15 +769,15 @@ Phaser.Math = {
     },
 
     /**
-    * Keeps an angle value between -180 and +180<br>
-    * Should be called whenever the angle is updated on the Sprite to stop it from going insane.
+    * Keeps an angle value between -180 and +180.
     *
     * @method Phaser.Math#wrapAngle
     * @param {number} angle - The angle value to check
-    * @param {boolean} radians - True if angle sizes are expressed in radians.
+    * @param {boolean} radians - True if angle is given in radians.
     * @return {number} The new angle value, returns the same as the input angle if it was within bounds.
     */
     wrapAngle: function (angle, radians) {
+
         var radianFactor = (radians) ? Math.PI / 180 : 1;
         return this.wrap(angle, -180 * radianFactor, 180 * radianFactor);
 

src/time/Timer.js

@@ -103,6 +103,12 @@ Phaser.Timer = function (game, autoDestroy) {
     */
     this._len = 0;
 
+    /**
+    * @property {number} _marked - Temp. counter variable.
+    * @private
+    */
+    this._marked = 0;
+
     /**
     * @property {number} _i - Temp. array counter variable.
     * @private
@@ -377,6 +383,7 @@ Phaser.Timer.prototype = {
         }
 
         this._now = time;
+        this._marked = 0;
 
         //  Clears events marked for deletion and resets _len and _i to 0.
         this.clearPendingEvents();
@@ -408,6 +415,7 @@ Phaser.Timer.prototype = {
                     }
                     else
                     {
+                        this._marked++;
                         this.events[this._i].pendingDelete = true;
                         this.events[this._i].callback.apply(this.events[this._i].callbackContext, this.events[this._i].args);
                     }
@@ -421,7 +429,7 @@ Phaser.Timer.prototype = {
             }
 
             //  Are there any events left?
-            if (this.events.length > 0)
+            if (this.events.length > this._marked)
             {
                 this.order();
             }