Add a "Created" state for new containers that haven't been run yet

Closes #13353

Signed-off-by: Doug Davis <dug@us.ibm.com>

docs/man/docker-create.1.md

@@ -56,6 +56,16 @@ docker-create - Create a new container
 [**--cgroup-parent**[=*CGROUP-PATH*]]
 IMAGE [COMMAND] [ARG...]
 
+# DESCRIPTION
+
+Creates a writeable container layer over the specified image and prepares it for
+running the specified command. The container ID is then printed to STDOUT. This
+is similar to **docker run -d** except the container is never started. You can 
+then use the **docker start <container_id>** command to start the container at
+any point.
+
+The initial status of the container created with **docker create** is 'created'.
+
 # OPTIONS
 **-a**, **--attach**=[]
    Attach to STDIN, STDOUT or STDERR.

docs/man/docker-ps.1.md

@@ -37,7 +37,7 @@ the running containers.
    Provide filter values. Valid filters:
                           exited=<int> - containers with exit code of <int>
                           label=<key> or label=<key>=<value>
-                          status=(restarting|running|paused|exited)
+                          status=(created|restarting|running|paused|exited)
                           name=<string> - container's name
                           id=<ID> - container's ID
 

docs/sources/reference/api/docker_remote_api_v1.20.md

@@ -92,7 +92,7 @@ Query Parameters:
         sizes
 -   **filters** - a JSON encoded value of the filters (a `map[string][]string`) to process on the containers list. Available filters:
   -   `exited=<int>`; -- containers with exit code of  `<int>` ;
-  -   `status=`(`restarting`|`running`|`paused`|`exited`)
+  -   `status=`(`created`|`restarting`|`running`|`paused`|`exited`)
   -   `label=key` or `key=value` of a container label
 
 Status Codes:

docs/sources/reference/commandline/cli.md

@@ -1033,7 +1033,8 @@ except the container is never started.  You can then use the `docker start
 <container_id>` command to start the container at any point.
 
 This is useful when you want to set up a container configuration ahead of time
-so that it is ready to start when you need it.
+so that it is ready to start when you need it. The initial status of the
+new container is `created`.
 
 Please see the [run command](#run) section and the [Docker run reference](
 /reference/run/) for more details.
@@ -1760,7 +1761,7 @@ The currently supported filters are:
 * label (`label=<key>` or `label=<key>=<value>`)
 * name (container's name)
 * exited (int - the code of exited containers. Only useful with `--all`)
-* status (restarting|running|paused|exited)
+* status (created|restarting|running|paused|exited)
 
 ##### Successfully exited containers