More JSDocs added.

Author: photonstorm

v3/src/math/Within.js

@@ -1,11 +1,15 @@
 /**
-* Checks if two values are within the given tolerance of each other.
-*
-* @param {number} a - The first number to check
-* @param {number} b - The second number to check
-* @param {number} tolerance - The tolerance. Anything equal to or less than this is considered within the range.
-* @return {boolean} True if a is <= tolerance of b.
-*/
+ * Checks if the two values are within the given `tolerance` of each other.
+ *
+ * @function Phaser.Math.Within
+ * @since 3.0.0
+ *
+ * @param {number} a - [description]
+ * @param {number} b - [description]
+ * @param {number} tolerance - The tolerance. Anything equal to or less than this value is considered as being within range.
+ *
+ * @return {boolean} Returns `true` if `a` is less than or equal to the tolerance of `b`.
+ */
 var Within = function (a, b, tolerance)
 {
     return (Math.abs(a - b) <= tolerance);

v3/src/math/Wrap.js

@@ -1,3 +1,15 @@
+/**
+ * [description]
+ *
+ * @function Phaser.Math.Wrap
+ * @since 3.0.0
+ *
+ * @param {number} value - [description]
+ * @param {number} min - [description]
+ * @param {number} max - [description]
+ *
+ * @return {number} [description]
+ */
 var Wrap = function (value, min, max)
 {
     var range = max - min;

v3/src/scene/global/inc/Add.js

@@ -1,14 +1,28 @@
 var Scene = require('../../local/Scene');
 
 /**
-* Adds a new Scene into the GlobalSceneManager. You must give each Scene a unique key by which you'll identify it.
-* The Scene can be either a Phaser.Scene object (or an object that extends it), a plain JavaScript object or a function.
-* If a function is given a new scene object will be created by calling it.
-*
-* @param {string} key - A unique key you use to reference this scene, i.e. "MainMenu", "Level1".
-* @param {Phaser.Scene|object|function} scene  - The scene you want to switch to.
-* @param {boolean} [autoStart=false]  - If true the Scene will be started immediately after adding it.
-*/
+ * Adds a new Scene into the SceneManager.
+ * You must give each Scene a unique key by which you'll identify it.
+ *
+ * The `sceneConfig` can be:
+ *
+ * * A `Phaser.Scene` object, or an object that extends it.
+ * * A plain JavaScript object
+ * * A JavaScript ES6 Class that extends `Phaser.Scene`
+ * * A JavaScript ES5 prototype based Class
+ * * A JavaScript function
+ *
+ * If a function is given then a new Scene will be created by calling it.
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#add
+ * @since 3.0.0
+ *
+ * @param {string} key - A unique key used to reference the Scene, i.e. `MainMenu` or `Level1`.
+ * @param {Phaser.Scene|object|function} sceneConfig - [description]
+ * @param {boolean} [autoStart=false] - If `true` the Scene will be started immediately after being added.
+ *
+ * @return {Phaser.Scene} [description]
+ */
 var Add = function (key, sceneConfig, autoStart)
 {
     if (autoStart === undefined) { autoStart = false; }

v3/src/scene/global/inc/Boot.js

@@ -1,7 +1,9 @@
 /**
-* The Boot handler is called by Phaser.Game when it first starts up.
-* The renderer is available by now.
-*/
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#boot
+ * @since 3.0.0
+ */
 var Boot = function ()
 {
     var i;

v3/src/scene/global/inc/BootScene.js

@@ -1,3 +1,11 @@
+/**
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#bootScene
+ * @since 3.0.0
+ *
+ * @param {Phaser.Scene} scene - [description]
+ */
 var BootScene = function (scene)
 {
     if (scene.init)

v3/src/scene/global/inc/BringToTop.js

@@ -1,6 +1,14 @@
 //  If the arguments are strings they are assumed to be keys, otherwise they are Scene objects
 //  You can only swap the positions of Active (rendering / updating) Scenes. If a Scene is not active it cannot be moved.
 
+/**
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#bringToTop
+ * @since 3.0.0
+ *
+ * @param {string|Phaser.Scene} scene - [description]
+ */
 var BringToTop = function (scene)
 {
     var index = (typeof scene === 'string') ? this.getActiveSceneIndexByKey(scene) : this.getActiveSceneIndex(scene);

v3/src/scene/global/inc/Create.js

@@ -1,5 +1,13 @@
 var SortScenes = require('./SortScenes');
 
+/**
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#create
+ * @since 3.0.0
+ *
+ * @param {Phaser.Scene} scene - [description]
+ */
 var Create = function (scene)
 {
     //  Insert at the correct index, or it just all goes wrong :)

v3/src/scene/global/inc/CreateSceneDisplay.js

@@ -3,6 +3,14 @@ var CONST = require('../../../const');
 var GetContext = require('../../../canvas/GetContext');
 var CanvasInterpolation = require('../../../dom/CanvasInterpolation');
 
+/**
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#createSceneDisplay
+ * @since 3.0.0
+ *
+ * @param {Phaser.Scene} scene - [description]
+ */
 var CreateSceneDisplay = function (scene)
 {
     var settings = scene.sys.settings;

v3/src/scene/global/inc/CreateSceneFromFunction.js

@@ -2,6 +2,17 @@ var Scene = require('../../local/Scene');
 var Systems = require('../../local/Systems');
 var NOOP = require('../../../utils/NOOP');
 
+/**
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#createSceneFromFunction
+ * @since 3.0.0
+ *
+ * @param {string} key - [description]
+ * @param {function} scene - [description]
+ *
+ * @return {Phaser.Scene} [description]
+ */
 var CreateSceneFromFunction = function (key, scene)
 {
     var newScene = new scene();

v3/src/scene/global/inc/CreateSceneFromInstance.js

@@ -1,3 +1,14 @@
+/**
+ * [description]
+ *
+ * @method Phaser.Scenes.GlobalSceneManager#createSceneFromInstance
+ * @since 3.0.0
+ *
+ * @param {string} key - [description]
+ * @param {Phaser.Scene} newScene - [description]
+ *
+ * @return {Phaser.Scene} [description]
+ */
 var CreateSceneFromInstance = function (key, newScene)
 {
     var configKey = newScene.sys.settings.key;