Style fixes. Copied docs to APIClient as well

Signed-off-by: Joffrey F <joffrey@docker.com>

docker/api/exec_api.py

@@ -122,10 +122,13 @@ class ExecApiMixin(object):
                 Default: False
             tty (bool): Allocate a pseudo-TTY. Default: False
             stream (bool): Stream response data. Default: False
+            socket (bool): Return the connection socket to allow custom
+                read/write operations.
 
         Returns:
             (generator or str): If ``stream=True``, a generator yielding
-            response chunks. A string containing response data otherwise.
+            response chunks. If ``socket=True``, a socket object for the
+            connection. A string containing response data otherwise.
 
         Raises:
             :py:class:`docker.errors.APIError`

docker/models/containers.py

@@ -142,7 +142,8 @@ class Container(Model):
             detach (bool): If true, detach from the exec command.
                 Default: False
             stream (bool): Stream response data. Default: False
-            socket (bool): Whether to return a socket object or not. Default: False
+            socket (bool): Return the connection socket to allow custom
+                read/write operations. Default: False
             environment (dict or list): A dictionary or a list of strings in
                 the following format ``["PASSWORD=xxx"]`` or
                 ``{"PASSWORD": "xxx"}``.
@@ -150,7 +151,7 @@ class Container(Model):
         Returns:
             (generator or str):
                 If ``stream=True``, a generator yielding response chunks.
-                If ``socket=True``, a socket object of the connection (an SSL wrapped socket for TLS-based docker, on which one must call ``sendall`` and ``recv`` -- and **not** os.read / os.write).
+                If ``socket=True``, a socket object for the connection.
                 A string containing response data otherwise.
         Raises:
             :py:class:`docker.errors.APIError`