Update docs.

Author: willwhite

API.md

@@ -1,19 +1,39 @@
-# MapboxDirections
+<!-- Generated by documentation.js. Update this documentation by updating the source code. -->
+
+### Table of Contents
+
+-   [MapboxDirections](#mapboxdirections)
+    -   [onRemove](#onremove)
+    -   [interactive](#interactive)
+    -   [getOrigin](#getorigin)
+    -   [setOrigin](#setorigin)
+    -   [getDestination](#getdestination)
+    -   [setDestination](#setdestination)
+    -   [reverse](#reverse)
+    -   [addWaypoint](#addwaypoint)
+    -   [setWaypoint](#setwaypoint)
+    -   [removeWaypoint](#removewaypoint)
+    -   [getWaypoints](#getwaypoints)
+    -   [removeRoutes](#removeroutes)
+    -   [on](#on)
+
+## MapboxDirections
 
 The Directions control
 
 **Parameters**
 
 -   `options` **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** 
-    -   `options.styles` **\[[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)]** Override default layer properties of the [directions source](https://github.com/mapbox/mapbox-gl-directions/blob/master/src/directions_style.js). Documentation for each property are specified in the [Mapbox GL Style Reference](https://www.mapbox.com/mapbox-gl-style-spec/).
-    -   `options.accessToken` **\[[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** Required unless `mapboxgl.accessToken` is set globally (optional, default `null`)
-    -   `options.interactive` **\[[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** Enable/Disable mouse or touch interactivity from the plugin (optional, default `true`)
-    -   `options.profile` **\[[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** Routing profile to use. Options: `driving-traffic`, `driving`, `walking`, `cycling` (optional, default `"driving-traffic"`)
-    -   `options.unit` **\[[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)]** Measurement system to be used in navigation instructions. Options: `imperial`, `metric` (optional, default `"imperial"`)
-    -   `options.geocoder` **\[[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)]** Pass options available to mapbox-gl-geocoder as [documented here](https://github.com/mapbox/mapbox-gl-geocoder/blob/master/API.md#mapboxglgeocoder).
-    -   `options.controls` **\[[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)]** 
-        -   `options.controls.inputs` **\[[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** Hide or display the inputs control. (optional, default `true`)
-        -   `options.controls.instructions` **\[[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)]** Hide or display the instructions control. (optional, default `true`)
+    -   `options.styles` **[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)?** Override default layer properties of the [directions source](https://github.com/mapbox/mapbox-gl-directions/blob/master/src/directions_style.js). Documentation for each property are specified in the [Mapbox GL Style Reference](https://www.mapbox.com/mapbox-gl-style-spec/).
+    -   `options.accessToken` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** Required unless `mapboxgl.accessToken` is set globally (optional, default `null`)
+    -   `options.interactive` **[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** Enable/Disable mouse or touch interactivity from the plugin (optional, default `true`)
+    -   `options.profile` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** Routing profile to use. Options: `driving-traffic`, `driving`, `walking`, `cycling` (optional, default `"driving-traffic"`)
+    -   `options.alternatives` **[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** Whether to enable alternatives. (optional, default `true`)
+    -   `options.unit` **[String](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String)** Measurement system to be used in navigation instructions. Options: `imperial`, `metric` (optional, default `"imperial"`)
+    -   `options.geocoder` **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)?** Pass options available to mapbox-gl-geocoder as [documented here](https://github.com/mapbox/mapbox-gl-geocoder/blob/master/API.md#mapboxglgeocoder).
+    -   `options.controls` **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)?** 
+        -   `options.controls.inputs` **[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** Hide or display the inputs control. (optional, default `true`)
+        -   `options.controls.instructions` **[Boolean](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean)** Hide or display the instructions control. (optional, default `true`)
 
 **Examples**
 
@@ -30,7 +50,7 @@ map.addControl(directions);
 
 Returns **[MapboxDirections](#mapboxdirections)** `this`
 
-## onRemove
+### onRemove
 
 Removes the control from the map it has been added to. This is called by `map.removeControl`,
 which is the recommended method to remove controls.
@@ -41,7 +61,7 @@ which is the recommended method to remove controls.
 
 Returns **Control** `this`
 
-## interactive
+### interactive
 
 Turn on or off interactivity
 
@@ -51,13 +71,13 @@ Turn on or off interactivity
 
 Returns **[MapboxDirections](#mapboxdirections)** this
 
-## getOrigin
+### getOrigin
 
 Returns the origin of the current route.
 
 Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** origin
 
-## setOrigin
+### setOrigin
 
 Sets origin. _Note:_ calling this method requires the [map load event](https://www.mapbox.com/mapbox-gl-js/api/#Map.load)
 to have run.
@@ -68,13 +88,13 @@ to have run.
 
 Returns **[MapboxDirections](#mapboxdirections)** this
 
-## getDestination
+### getDestination
 
 Returns the destination of the current route.
 
 Returns **[Object](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object)** destination
 
-## setDestination
+### setDestination
 
 Sets destination. _Note:_ calling this method requires the [map load event](https://www.mapbox.com/mapbox-gl-js/api/#Map.load)
 to have run.
@@ -85,13 +105,13 @@ to have run.
 
 Returns **[MapboxDirections](#mapboxdirections)** this
 
-## reverse
+### reverse
 
 Swap the origin and destination.
 
 Returns **[MapboxDirections](#mapboxdirections)** this
 
-## addWaypoint
+### addWaypoint
 
 Add a waypoint to the route. _Note:_ calling this method requires the
 [map load event](https://www.mapbox.com/mapbox-gl-js/api/#Map.load) to have run.
@@ -103,7 +123,7 @@ Add a waypoint to the route. _Note:_ calling this method requires the
 
 Returns **[MapboxDirections](#mapboxdirections)** this;
 
-## setWaypoint
+### setWaypoint
 
 Change the waypoint at a given index in the route. _Note:_ calling this
 method requires the [map load event](https://www.mapbox.com/mapbox-gl-js/api/#Map.load)
@@ -116,7 +136,7 @@ to have run.
 
 Returns **[MapboxDirections](#mapboxdirections)** this;
 
-## removeWaypoint
+### removeWaypoint
 
 Remove a waypoint from the route.
 
@@ -126,19 +146,19 @@ Remove a waypoint from the route.
 
 Returns **[MapboxDirections](#mapboxdirections)** this;
 
-## getWaypoints
+### getWaypoints
 
 Fetch all current waypoints in a route.
 
 Returns **[Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array)** waypoints
 
-## removeRoutes
+### removeRoutes
 
 Removes all routes and waypoints from the map.
 
 Returns **[MapboxDirections](#mapboxdirections)** this;
 
-## on
+### on
 
 Subscribe to events that happen within the plugin.