jsdoc update.

Author: photonstorm

src/gameobjects/components/Core.js

@@ -240,8 +240,10 @@ Phaser.Component.Core.prototype = {
 
     /**
     * A Game Object is that is pendingDestroy is flagged to have its destroy method called on the next logic update.
-    * This is used internally by the likes of Buttons but you can also set it directly, to allow you to flag an
-    * object to be destroyed from within one of its own callbacks (such as a Button or Input event)
+    * You can set it directly to allow you to flag an object to be destroyed on its next update.
+    * 
+    * This is extremely useful if you wish to destroy and object from within one of its own callbacks 
+    * such as with Buttons or other Input events.
     * 
     * @property {boolean} pendingDestroy
     */