issue #4557: Updates comments for EventListener::setEnabled/setPaused.

Also does whitespace cleanup and untabify codes. Thanks emacs. :)

cocos/2d/CCEventListener.h

@@ -22,8 +22,8 @@
  THE SOFTWARE.
  ****************************************************************************/
 
-#ifndef cocos2d_libs_EventListener_h
-#define cocos2d_libs_EventListener_h
+#ifndef __CCEVENTLISTENER_H__
+#define __CCEVENTLISTENER_H__
 
 #include "CCPlatformMacros.h"
 #include "CCRef.h"
@@ -78,8 +78,8 @@ public:
     /** Enables or disables the listener
      *  @note Only listeners with `enabled` state will be able to receive events.
      *        When an listener was initialized, it's enabled by default.
-     *        For a `scene graph priority` listener, to receive an event, excepting it was `enabled`,
-     *        it also shouldn't be in `pause` state.
+     *        An event listener can receive events when it is enabled and is not paused.
+     *        paused state is always false when it is a fixed priority listener.
      */
     inline void setEnabled(bool enabled) { _isEnabled = enabled; };
 
@@ -88,12 +88,13 @@ public:
 
 protected:
 
-    /** Sets pause state for the listener
+    /** Sets paused state for the listener
      *  The paused state is only used for scene graph priority listeners.
      *  `EventDispatcher::resumeAllEventListenersForTarget(node)` will set the paused state to `true`,
      *  while `EventDispatcher::pauseAllEventListenersForTarget(node)` will set it to `false`.
-     *  @note Fixed priority listeners will never get paused. If a fixed priority doesn't want to receive events,
-     *        call `setEnabled(false)` instead.
+     *  @note 1) Fixed priority listeners will never get paused. If a fixed priority doesn't want to receive events,
+     *           call `setEnabled(false)` instead.
+     *        2) In `Node`'s onEnter and onExit, listeners associated with that node will automatically update their `paused state`.
      */
     inline void setPaused(bool paused) { _paused = paused; };
 
@@ -153,4 +154,4 @@ protected:
 
 NS_CC_END
 
-#endif
+#endif // __CCEVENTLISTENER_H__