Tidying up some docs.

Author: photonstorm

README.md

@@ -44,6 +44,7 @@ Version 1.1.3 - in build
 * New: Added Mouse.pointerLock signal which you can listen to whenever the browser enters or leaves pointer lock mode.
 * New: StageScaleMode.forceOrientation allows you to lock your game to one orientation and display a Sprite (i.e. a "please rotate" screen) when incorrect.
 * New: World.visible boolean added, toggles rendering of the world on/off entirely.
+* New: Polygon class & drawPolygon method added to Graphics (thanks rjimenezda)
 * Fixed: Mouse.stop now uses the true useCapture, which means the event listeners stop listening correctly (thanks beeglebug)
 * Fixed: Input Keyboard example fix (thanks Atrodilla)
 * Updated: ArcadePhysics.updateMotion applies the dt to the velocity calculations as well as position now (thanks jcs)

src/utils/Utils.js

@@ -10,6 +10,12 @@
 */
 Phaser.Utils = {
 
+	/**
+	* A standard Fisher-Yates Array shuffle implementation.
+	* @method Phaser.Utils.shuffle
+	* @param {array} array - The array to shuffle.
+	* @return {array} The shuffled array.
+	*/
 	shuffle: function (array) {
 
 	    for (var i = array.length - 1; i > 0; i--)
@@ -26,14 +32,14 @@ Phaser.Utils = {
 
 	/**
 	* Javascript string pad http://www.webtoolkit.info/.
-	* pad = the string to pad it out with (defaults to a space)<br>
+	* pad = the string to pad it out with (defaults to a space)
 	* dir = 1 (left), 2 (right), 3 (both)
 	* @method Phaser.Utils.pad
 	* @param {string} str - The target string. 
 	* @param {number} len - Description.
 	* @param {number} pad - the string to pad it out with (defaults to a space).
 	* @param {number} [dir=3] the direction dir = 1 (left), 2 (right), 3 (both).
-	* @return {string}
+	* @return {string} The padded string
 	*/
 	pad: function (str, len, pad, dir) {