Merge pull request #590 from docker/events_decode_doc

Added documentation for decode param on stats and events

Author: shin-

docs/api.md

@@ -250,10 +250,10 @@ function return a blocking generator you can iterate over to retrieve events as
 **Params**:
 
 * since (datetime or int): get events from this point
-
 * until (datetime or int): get events until this point
-
 * filters (dict): filter the events by event time, container or image
+* decode (bool): If set to true, stream will be decoded into dicts on the
+  fly. False by default.
 
 **Returns** (generator):
 
@@ -812,6 +812,8 @@ This will stream statistics for a specific container.
 **Params**:
 
 * container (str): The container to start
+* decode (bool): If set to true, stream will be decoded into dicts on the
+  fly. False by default.
 
 ```python
 >>> from docker import Client
@@ -914,7 +916,6 @@ If `container` a dict, the `Id` key is used.
 <!---
 TODO:
 
-* events
 * load_image
 * resize