refactor: fixes #2, #6, #12 and #13

1 files changed, 25 insertions, 20 deletions

diff --git a/README.md b/README.md
index 46ec287..9cc5b1a 100644
--- a/README.md
+++ b/README.md
@@ -6,21 +6,18 @@
   <a href="https://www.npmjs.org/package/mitt"><img src="https://img.shields.io/npm/v/mitt.svg?style=flat" alt="npm"></a> <a href="https://travis-ci.org/developit/mitt"><img src="https://travis-ci.org/developit/mitt.svg?branch=master" alt="travis"></a>
 </p>
 
-
 ## Why Mitt?
 
-- **Microscopic:** weighs less than 200 bytes gzipped
-- **Useful:** a wildcard `"*"` event type listens to all events
-- **Familiar:** same names & ideas as [Node's EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
-- **Functional:** methods don't rely on `this`
-- **Great Name:** somehow [mitt](https://npm.im/mitt) wasn't taken
+-   **Microscopic:** weighs less than 200 bytes gzipped
+-   **Useful:** a wildcard `"*"` event type listens to all events
+-   **Familiar:** same names & ideas as [Node's EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
+-   **Functional:** methods don't rely on `this`
+-   **Great Name:** somehow [mitt](https://npm.im/mitt) wasn't taken
 
 > Mitt was made for the browser, but works in any JavaScript runtime. It has no dependencies and only uses basic language features. It probably works in Internet Explorer 5.
 
-
 * * *
 
-
 ## Usage
 
 After installing via `npm install --save mitt`:
@@ -55,16 +52,32 @@ Mitt: Tiny (~200b) functional event emitter / pubsub.
 
 Returns **Mitt** 
 
-#### on
+#### emit
+
+Invoke all handlers for the given type.
+If present, `"*"` handlers are invoked prior to type-matched handlers.
+
+**Parameters**
+
+-   `type` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** The event type to invoke
+-   `arg1` **\[Any]** A value (first argument), passed to each handler
+-   `arg2` **\[Any]** A value (second argument), passed to each handler
+-   `arg3` **\[Any]** A value (third argument), passed to each handler
+
+Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** the `mitt` instance for chaining
+
+### on
 
 Register an event handler for the given type.
 
 **Parameters**
 
 -   `type` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** Type of event to listen for, or `"*"` for all events
--   `handler` **[Function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function)** Function to call in response to the given event
+-   `handler` **[Function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function)** Function to call in response to given event
+
+Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** the `mitt` instance for chaining
 
-#### off
+### off
 
 Remove an event handler for the given type.
 
@@ -73,12 +86,4 @@ Remove an event handler for the given type.
 -   `type` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** Type of event to unregister `handler` from, or `"*"`
 -   `handler` **[Function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/function)** Handler function to remove
 
-#### emit
-
-Invoke all handlers for the given type.
-If present, `"*"` handlers are invoked prior to type-matched handlers.
-
-**Parameters**
-
--   `type` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** The event type to invoke
--   `event` **\[Any]** An event object, passed to each handler
+Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** the `mitt` instance for chaining