doc: update docs

Author: GochoMugo

README.md

@@ -6,25 +6,25 @@ A **Query Engine** for building interactive prompts.
  [![Supported Node.js Versions](https://img.shields.io/badge/node->=7-green.svg)](https://github.com/forfuturellc/mau)
 
 
-**table of contents:**
+**Table of Contents**
 
-* [installation](#installation)
-* [examples](example/README.md)
-* [API reference](doc/api.md)
+* [Installation](#installation)
+* [Examples](example/README.md)
+* [API Reference](doc/api.md)
 * [Specifications](doc/spec.md)
-* [license](#license)
+* [License](#license)
 
 
 <a name="installation"></a>
-## installation:
+## Installation
 
 ```bash
 $ npm install --save mau
 ```
 
 
 <a name="license"></a>
-## license:
+## License
 
 ***The MIT License (MIT)***
 

doc/api.md

@@ -213,14 +213,14 @@ formset.processForm(name, 12345, ref);
 **Example** *(FormNotFoundError)*  
 ```js
 // Assuming there's no form with the name '404'.
-formset.processForm("404", chatID, ref, function(error) {
+formset.processForm("404", chatID, ref).catch(function(error) {
     assert.ok(error instanceof mau.errors.FormNotFoundError);
 });
 ```
 **Example** *(BusyError)*  
 ```js
 // Assuming there's a form already being processed.
-formset.processForm(name, chatID, ref, function(error) {
+formset.processForm(name, chatID, ref).catch(function(error) {
     assert.ok(error instanceof mau.errors.BusyError);
 });
 ```
@@ -247,15 +247,13 @@ which if not found, a `FormNotFoundError` error is thrown.
 **Example**  
 ```js
 // Assuming there's a form named 'hello'
-try {
-     await formset.process(chatID, text, ref);
-} catch (error) {
-     if (error && error instanceof mau.errors.FormNotFoundError) {
+await formset.process(chatID, text, ref).catch(function (error) {
+     if (error instanceof mau.errors.FormNotFoundError) {
         // There's NO active form.
         // Let's trigger the 'hello' form.
         await formset.processForm("hello", chatID, text, ref);
     }
-}
+});
 ```
 <a name="FormSet+cancel"></a>
 

example/README.md

@@ -1,11 +1,11 @@
-## examples:
+## Examples
 
 * [setting up](#setting-up)
 * [examples](#examples)
 
 
 <a name="setting-up"></a>
-### setting up:
+### Setting up
 
 Clone this repository:
 
@@ -24,28 +24,22 @@ $ cd mau/
 $ npm install --only=prod
 ```
 
-Change into the `example/` directory:
+Change into the `example/` directory and install some
+additional dependencies are required to run the examples:
 
 ```bash
+# Change directory.
 $ cd example/
-```
-
-Some additional dependencies are required to run the
-examples. You'll need to install them:
-
-```bash
-# For ALL examples.
-$ npm install tgfancy
 
-# For example #2.
-$ npm install http-proxy ngrok
+# Install additional dependencies.
+$ npm install
 ```
 
 You will also need [Redis][redis] for example #2.
 
 
 <a name="examples"></a>
-### examples:
+### Examples
 
 * [Example #1](#example-1): A single Telegram bot
 * [Example #2](#example-2): Multiple Telegram bots
@@ -62,7 +56,7 @@ $ export TELEGRAM_TOKEN=xxxxx
 
 # Run the bot.
 # Leave out 'NO_REDIS=1' if you want to use Redis.
-$ NO_REDIS=1 node example/telegram.js
+$ NO_REDIS=1 node telegram.js
 ```
 
 **Time to Play**: Send your bot a message.
@@ -81,12 +75,12 @@ to be `6379`. Port can be changed using environment variable
 # In a separate shell, start a bot instance
 # listening on port 9101.
 $ export TELEGRAM_TOKEN=xxxxx
-$ node example/telegram.js 9101
+$ node telegram.js 9101
 
 # In another separate shell, start another instance
 # listening on port 9102.
 $ export TELEGRAM_TOKEN=xxxxx
-$ node example/telegram.js 9102
+$ node telegram.js 9102
 
 # ... Run more instances if you wish ...
 
@@ -95,7 +89,7 @@ $ node example/telegram.js 9102
 # Append the port numbers of any additional instances you have started. Mind the commas.
 # Leave out `PROXY_PORT=9100` to have proxy listen on its default port i.e. 9100.
 $ export TELEGRAM_TOKEN=xxxxx
-$ PROXY_PORT=9100 node example/proxy.js 9101,9102
+$ PROXY_PORT=9100 node proxy.js 9101,9102
 ```
 
 **Time to Play**: Send your bot a message.

lib/formset.js

@@ -115,13 +115,13 @@ class FormSet extends EventEmitter {
      *
      * @example <caption>FormNotFoundError</caption>
      * // Assuming there's no form with the name '404'.
-     * formset.processForm("404", chatID, ref, function(error) {
+     * formset.processForm("404", chatID, ref).catch(function(error) {
      *     assert.ok(error instanceof mau.errors.FormNotFoundError);
      * });
      *
      * @example <caption>BusyError</caption>
      * // Assuming there's a form already being processed.
-     * formset.processForm(name, chatID, ref, function(error) {
+     * formset.processForm(name, chatID, ref).catch(function(error) {
      *     assert.ok(error instanceof mau.errors.BusyError);
      * });
      *
@@ -153,15 +153,13 @@ class FormSet extends EventEmitter {
      *
      * @example
      * // Assuming there's a form named 'hello'
-     * try {
-     *      await formset.process(chatID, text, ref);
-     * } catch (error) {
-     *      if (error && error instanceof mau.errors.FormNotFoundError) {
+     * await formset.process(chatID, text, ref).catch(function (error) {
+     *      if (error instanceof mau.errors.FormNotFoundError) {
      *         // There's NO active form.
      *         // Let's trigger the 'hello' form.
      *         await formset.processForm("hello", chatID, text, ref);
      *     }
-     * }
+     * });
      *
      * @param  {String|Number} chatID Unique identifier for the originating
      *  chat