diff --git a/docs/sources/commandline/cli.rst b/docs/sources/commandline/cli.rst
index d7bb03b954..43ef0f89b2 100644
--- a/docs/sources/commandline/cli.rst
+++ b/docs/sources/commandline/cli.rst
@@ -930,6 +930,9 @@ containers will not be deleted.
       -link="": Add link to another container (name:alias)
       -name="": Assign the specified name to the container. If no name is specific docker will generate a random name
       -P=false: Publish all exposed ports to the host interfaces
+      
+``docker run`` ``creates`` a writeable container layer over the specified image, and then 
+``start``s it using the specified command (ie. is equivalent to the API ``/containers/create`` then ``/containers/(id)/start``). 
 
 Known Issues (run -volumes-from)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~