updated docs & tests

Docker-DCO-1.1-Signed-off-by: Victor Vieux <vieux@docker.com> (github: vieux)
Upstream-commit: 957c510d729ac3dcbe892b145fb2d9ed766be2ca
Component: engine

components/engine/docs/sources/reference/api/docker_remote_api.md

@@ -49,6 +49,11 @@ daemon is configured to listen on.
 **New!**
 `start` and `stop` will now return 304 if the container's status is not modified
 
+`POST /commit`
+
+**New!**
+Added a `pause` parameter (default `true`) to pause the container during commit
+
 ## v1.12
 
 ### Full Documentation

components/engine/docs/sources/reference/commandline/cli.md

@@ -346,7 +346,7 @@ is better to use Dockerfiles to manage your images in a documented and
 maintainable way.
 
 By default, the container being committed and its processes will be paused
-during the process of committing the image. This reduces the likelihood of
+while the image is committed. This reduces the likelihood of
 encountering data corruption during the process of creating the commit.
 If this behavior is undesired, set the 'p' option to false.