Tidying up code and docs.

Author: photonstorm

README.md

@@ -277,6 +277,7 @@ If you are an exceptional JavaScript developer and would like to join the Phaser
 * The Health Game Object component has a new method: `setHealth` which allows you to set the exact health amount. This is now used by the `revive` function.
 * Text.useAdvancedWrap allows you to swap between the Basic and the Advanced word wrapping functions. In Advanced it will wrap long-words and condense and trim excess white space (thanks @soldoutactivist #1811)
 * The Grunt script has been updated to enhance the intro / outro and Pixi defaults. Pixi has been split into intro / outro and main blocks, so you can exclude its intro cleanly. The excludes are now bound, so if you exclude the Phaser UMD it will do the same for Pixi as well (thanks @spayton #2192)
+* ArcadePhysics.worldAngleToPointer will get the angle (in radians) between a display object and the pointer, taking all parent rotations into account (thanks @mattrick16 #2171)
 
 ### Updates
 

src/physics/arcade/World.js

@@ -1699,20 +1699,23 @@ Phaser.Physics.Arcade.prototype = {
     }
 
     /**
-    * Find the angle in radians between a display object (like a Sprite) and a Pointer, taking their x/y and center into account relative to the world.
+    * Find the angle in radians between a display object (like a Sprite) and a Pointer, 
+    * taking their x/y and center into account relative to the world.
     *
     * @method Phaser.Physics.Arcade#worldAngleToPointer
     * @param {any} displayObject - The DisplayObjerct to test from.
     * @param {Phaser.Pointer} [pointer] - The Phaser.Pointer to test to. If none is given then Input.activePointer is used.
-    * @return {number} The angle in radians between displayObject.x/y to Pointer.x/y
+    * @return {number} The angle in radians between displayObject.world.x/y to Pointer.worldX / worldY
     */
-     worldAngleToPointer: function (displayObject, pointer) {
+    worldAngleToPointer: function (displayObject, pointer) {
+
         pointer = pointer || game.input.activePointer;
 
         var dx = pointer.worldX - displayObject.world.x;
         var dy = pointer.worldY - displayObject.world.y;
 
         return Math.atan2(dy, dx);
+
     }
 
 };