@@ -17,7 +17,7 @@ var PluginManager = require('../boot/PluginManager');
1717 * @constructor
1818 * @since 3.0.0
1919 *
20- * @param {Phaser.Scene } scene - [description]
20+ * @param {Phaser.Scene } scene - The Scene that this ScenePlugin belongs to.
2121 */
2222var ScenePlugin = new Class ( {
2323
@@ -26,7 +26,7 @@ var ScenePlugin = new Class({
2626 function ScenePlugin ( scene )
2727 {
2828 /**
29- * [description]
29+ * The Scene that this ScenePlugin belongs to.
3030 *
3131 * @name Phaser.Scenes.ScenePlugin#scene
3232 * @type {Phaser.Scene }
@@ -35,7 +35,7 @@ var ScenePlugin = new Class({
3535 this . scene = scene ;
3636
3737 /**
38- * [description]
38+ * The Scene Systems instance of the Scene that this ScenePlugin belongs to.
3939 *
4040 * @name Phaser.Scenes.ScenePlugin#systems
4141 * @type {Phaser.Scenes.Systems }
@@ -49,7 +49,7 @@ var ScenePlugin = new Class({
4949 }
5050
5151 /**
52- * [description]
52+ * The settings of the Scene this ScenePlugin belongs to.
5353 *
5454 * @name Phaser.Scenes.ScenePlugin#settings
5555 * @type {SettingsObject }
@@ -58,7 +58,7 @@ var ScenePlugin = new Class({
5858 this . settings = scene . sys . settings ;
5959
6060 /**
61- * [description]
61+ * The key of the Scene this ScenePlugin belongs to.
6262 *
6363 * @name Phaser.Scenes.ScenePlugin#key
6464 * @type {string }
@@ -67,7 +67,7 @@ var ScenePlugin = new Class({
6767 this . key = scene . sys . settings . key ;
6868
6969 /**
70- * [description]
70+ * The Game's SceneManager.
7171 *
7272 * @name Phaser.Scenes.ScenePlugin#manager
7373 * @type {Phaser.Scenes.SceneManager }
@@ -77,7 +77,9 @@ var ScenePlugin = new Class({
7777 } ,
7878
7979 /**
80- * [description]
80+ * Boot the ScenePlugin.
81+ *
82+ * Registers event handlers.
8183 *
8284 * @method Phaser.Scenes.ScenePlugin#boot
8385 * @since 3.0.0
@@ -96,8 +98,8 @@ var ScenePlugin = new Class({
9698 * @method Phaser.Scenes.ScenePlugin#start
9799 * @since 3.0.0
98100 *
99- * @param {string } key - [description]
100- * @param {object } [data] - [description]
101+ * @param {string } key - The Scene to start.
102+ * @param {object } [data] - The Scene data.
101103 *
102104 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
103105 */
@@ -125,9 +127,9 @@ var ScenePlugin = new Class({
125127 * @method Phaser.Scenes.ScenePlugin#add
126128 * @since 3.0.0
127129 *
128- * @param {string } key - [description]
129- * @param {object } sceneConfig - [description]
130- * @param {boolean } autoStart - [description]
130+ * @param {string } key - The Scene key.
131+ * @param {(Phaser.Scene|SettingsConfig|function) } sceneConfig - The config for the Scene.
132+ * @param {boolean } autoStart - Whether to start the Scene after it's added.
131133 *
132134 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
133135 */
@@ -144,8 +146,8 @@ var ScenePlugin = new Class({
144146 * @method Phaser.Scenes.ScenePlugin#launch
145147 * @since 3.0.0
146148 *
147- * @param {string } key - [description]
148- * @param {object } [data] - [description]
149+ * @param {string } key - The Scene to launch.
150+ * @param {object } [data] - The Scene data.
149151 *
150152 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
151153 */
@@ -172,7 +174,7 @@ var ScenePlugin = new Class({
172174 * @method Phaser.Scenes.ScenePlugin#pause
173175 * @since 3.0.0
174176 *
175- * @param {string } key - [description]
177+ * @param {string } key - The Scene to pause.
176178 *
177179 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
178180 */
@@ -191,7 +193,7 @@ var ScenePlugin = new Class({
191193 * @method Phaser.Scenes.ScenePlugin#resume
192194 * @since 3.0.0
193195 *
194- * @param {string } key - [description]
196+ * @param {string } key - The Scene to resume.
195197 *
196198 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
197199 */
@@ -210,7 +212,7 @@ var ScenePlugin = new Class({
210212 * @method Phaser.Scenes.ScenePlugin#sleep
211213 * @since 3.0.0
212214 *
213- * @param {string } key - [description]
215+ * @param {string } key - The Scene to put to sleep.
214216 *
215217 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
216218 */
@@ -229,7 +231,7 @@ var ScenePlugin = new Class({
229231 * @method Phaser.Scenes.ScenePlugin#wake
230232 * @since 3.0.0
231233 *
232- * @param {string } key - [description]
234+ * @param {string } key - The Scene to wake up.
233235 *
234236 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
235237 */
@@ -248,7 +250,7 @@ var ScenePlugin = new Class({
248250 * @method Phaser.Scenes.ScenePlugin#switch
249251 * @since 3.0.0
250252 *
251- * @param {string } key - [description]
253+ * @param {string } key - The Scene to start.
252254 *
253255 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
254256 */
@@ -275,7 +277,7 @@ var ScenePlugin = new Class({
275277 * @method Phaser.Scenes.ScenePlugin#stop
276278 * @since 3.0.0
277279 *
278- * @param {string } key - [description]
280+ * @param {string } key - The Scene to stop.
279281 *
280282 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
281283 */
@@ -294,7 +296,7 @@ var ScenePlugin = new Class({
294296 * @method Phaser.Scenes.ScenePlugin#setActive
295297 * @since 3.0.0
296298 *
297- * @param {boolean } value - [description]
299+ * @param {boolean } value - The Scene to set the active state for.
298300 *
299301 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
300302 */
@@ -311,7 +313,7 @@ var ScenePlugin = new Class({
311313 * @method Phaser.Scenes.ScenePlugin#setVisible
312314 * @since 3.0.0
313315 *
314- * @param {boolean } value - [description]
316+ * @param {boolean } value - The Scene to set the visible state for.
315317 *
316318 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
317319 */
@@ -328,9 +330,9 @@ var ScenePlugin = new Class({
328330 * @method Phaser.Scenes.ScenePlugin#isSleeping
329331 * @since 3.0.0
330332 *
331- * @param {string } key - [description]
333+ * @param {string } key - The Scene to check.
332334 *
333- * @return {boolean } [description]
335+ * @return {boolean } Whether the Scene is sleeping.
334336 */
335337 isSleeping : function ( key )
336338 {
@@ -345,9 +347,9 @@ var ScenePlugin = new Class({
345347 * @method Phaser.Scenes.ScenePlugin#isActive
346348 * @since 3.0.0
347349 *
348- * @param {string } key - [description]
350+ * @param {string } key - The Scene to check.
349351 *
350- * @return {boolean } [description]
352+ * @return {boolean } Whether the Scene is active.
351353 */
352354 isActive : function ( key )
353355 {
@@ -362,9 +364,9 @@ var ScenePlugin = new Class({
362364 * @method Phaser.Scenes.ScenePlugin#isVisible
363365 * @since 3.0.0
364366 *
365- * @param {string } key - [description]
367+ * @param {string } key - The Scene to check.
366368 *
367- * @return {boolean } [description]
369+ * @return {boolean } Whether the Scene is visible.
368370 */
369371 isVisible : function ( key )
370372 {
@@ -375,6 +377,7 @@ var ScenePlugin = new Class({
375377
376378 /**
377379 * Swaps the position of two scenes in the Scenes list.
380+ *
378381 * This controls the order in which they are rendered and updated.
379382 *
380383 * @method Phaser.Scenes.ScenePlugin#swapPosition
@@ -399,6 +402,7 @@ var ScenePlugin = new Class({
399402
400403 /**
401404 * Swaps the position of two scenes in the Scenes list, so that Scene B is directly above Scene A.
405+ *
402406 * This controls the order in which they are rendered and updated.
403407 *
404408 * @method Phaser.Scenes.ScenePlugin#moveAbove
@@ -423,6 +427,7 @@ var ScenePlugin = new Class({
423427
424428 /**
425429 * Swaps the position of two scenes in the Scenes list, so that Scene B is directly below Scene A.
430+ *
426431 * This controls the order in which they are rendered and updated.
427432 *
428433 * @method Phaser.Scenes.ScenePlugin#moveBelow
@@ -457,7 +462,7 @@ var ScenePlugin = new Class({
457462 * @method Phaser.Scenes.ScenePlugin#remove
458463 * @since 3.2.0
459464 *
460- * @param {(string|Phaser.Scene) } scene - The Scene to be removed.
465+ * @param {(string|Phaser.Scene) } key - The Scene to be removed.
461466 *
462467 * @return {Phaser.Scenes.SceneManager } This SceneManager.
463468 */
@@ -471,12 +476,12 @@ var ScenePlugin = new Class({
471476 } ,
472477
473478 /**
474- * [description]
479+ * Moves a Scene up one position in the Scenes list.
475480 *
476481 * @method Phaser.Scenes.ScenePlugin#moveUp
477482 * @since 3.0.0
478483 *
479- * @param {string } key - [description]
484+ * @param {string } key - The Scene to move.
480485 *
481486 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
482487 */
@@ -490,12 +495,12 @@ var ScenePlugin = new Class({
490495 } ,
491496
492497 /**
493- * [description]
498+ * Moves a Scene down one position in the Scenes list.
494499 *
495500 * @method Phaser.Scenes.ScenePlugin#moveDown
496501 * @since 3.0.0
497502 *
498- * @param {string } key - [description]
503+ * @param {string } key - The Scene to move.
499504 *
500505 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
501506 */
@@ -509,12 +514,14 @@ var ScenePlugin = new Class({
509514 } ,
510515
511516 /**
512- * [description]
517+ * Brings a Scene to the top of the Scenes list.
518+ *
519+ * This means it will render above all other Scenes.
513520 *
514521 * @method Phaser.Scenes.ScenePlugin#bringToTop
515522 * @since 3.0.0
516523 *
517- * @param {string } key - [description]
524+ * @param {string } key - The Scene to move.
518525 *
519526 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
520527 */
@@ -528,12 +535,14 @@ var ScenePlugin = new Class({
528535 } ,
529536
530537 /**
531- * [description]
538+ * Sends a Scene to the back of the Scenes list.
539+ *
540+ * This means it will render below all other Scenes.
532541 *
533542 * @method Phaser.Scenes.ScenePlugin#sendToBack
534543 * @since 3.0.0
535544 *
536- * @param {string } key - [description]
545+ * @param {string } key - The Scene to move.
537546 *
538547 * @return {Phaser.Scenes.ScenePlugin } This ScenePlugin object.
539548 */
@@ -547,22 +556,22 @@ var ScenePlugin = new Class({
547556 } ,
548557
549558 /**
550- * [description]
559+ * Retrieve a Scene.
551560 *
552561 * @method Phaser.Scenes.ScenePlugin#get
553562 * @since 3.0.0
554563 *
555- * @param {string } key - [description]
564+ * @param {string } key - The Scene to retrieve.
556565 *
557- * @return {Phaser.Scene } [description]
566+ * @return {Phaser.Scene } The Scene.
558567 */
559568 get : function ( key )
560569 {
561570 return this . manager . getScene ( key ) ;
562571 } ,
563572
564573 /**
565- * [description]
574+ * Shut down the given Scene.
566575 *
567576 * @method Phaser.Scenes.ScenePlugin#shutdown
568577 * @since 3.0.0
@@ -573,7 +582,7 @@ var ScenePlugin = new Class({
573582 } ,
574583
575584 /**
576- * [description]
585+ * Destroy the given Scene.
577586 *
578587 * @method Phaser.Scenes.ScenePlugin#destroy
579588 * @since 3.0.0
0 commit comments