Diff of /addon-sdk/source/doc/module-source/sdk/event/target.md [8c1a87] .. [d876f2] Maximize Restore

  Switch to side-by-side view

--- a/addon-sdk/source/doc/module-source/sdk/event/target.md
+++ b/addon-sdk/source/doc/module-source/sdk/event/target.md
@@ -104,6 +104,14 @@
 If there is no listener registered for `error` event or if it also throws
 exception then such exceptions are logged into a console.
 
+## Chaining
+
+Emitters can also have their methods chained:
+
+    target.on('message', handleMessage)
+      .on('data', parseData)
+      .on('error', handleError);
+
 <api name="EventTarget">
 @class
 `EventTarget` is an exemplar for creating an objects that can be used to
@@ -131,6 +139,8 @@
    The type of event.
 @param listener {Function}
    The listener function that processes the event.
+@returns {EventTarget}
+   Returns the EventTarget instance
 </api>
 
 <api name="once">
@@ -141,6 +151,8 @@
    The type of event.
 @param listener {Function}
    The listener function that processes the event.
+@returns {EventTarget}
+   Returns the EventTarget instance
 </api>
 
 <api name="removeListener">
@@ -150,6 +162,13 @@
    The type of event.
 @param listener {Function}
    The listener function that processes the event.
+@returns {EventTarget}
+   Returns the EventTarget instance
+</api>
+
+<api name="off">
+@method
+An alias for [removeListener](modules/sdk/event/target.html#removeListener(type, listener)).
 </api>
 
 </api>