Merge pull request #20386 from zhangjianfnst/fix-some-flaws-in-docs

Fix some flaws in docs

docs/reference/commandline/commit.md

@@ -31,7 +31,7 @@ volumes mounted inside the container.
 By default, the container being committed and its processes will be paused
 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.
+undesired, set the `--pause` option to false.
 
 The `--change` option will apply `Dockerfile` instructions to the image that is
 created.  Supported `Dockerfile` instructions:

docs/reference/commandline/cp.md

@@ -23,7 +23,7 @@ You can copy from the container's file system to the local machine or the
 reverse, from the local filesystem to the container. If `-` is specified for
 either the `SRC_PATH` or `DEST_PATH`, you can also stream a tar archive from
 `STDIN` or to `STDOUT`. The `CONTAINER` can be a running or stopped container.
-The `SRC_PATH` or `DEST_PATH` be a file or directory.
+The `SRC_PATH` or `DEST_PATH` can be a file or directory.
 
 The `docker cp` command assumes container paths are relative to the container's 
 `/` (root) directory. This means supplying the initial forward slash is optional;
@@ -85,4 +85,4 @@ It is not possible to copy certain system files such as resources under
 Using `-` as the `SRC_PATH` streams the contents of `STDIN` as a tar archive.
 The command extracts the content of the tar to the `DEST_PATH` in container's
 filesystem. In this case, `DEST_PATH` must specify a directory. Using `-` as
-`DEST_PATH` streams the contents of the resource as a tar archive to `STDOUT`.
+the `DEST_PATH` streams the contents of the resource as a tar archive to `STDOUT`.

docs/reference/commandline/events.md

@@ -37,7 +37,7 @@ Docker networks report the following events:
 
 The `--since` and `--until` parameters can be Unix timestamps, date formatted
 timestamps, or Go duration strings (e.g. `10m`, `1h30m`) computed
-relative to the client machine’s time. If you do not provide the --since option,
+relative to the client machine’s time. If you do not provide the `--since` option,
 the command returns only new and/or live events.  Supported formats for date
 formatted time stamps include RFC3339Nano, RFC3339, `2006-01-02T15:04:05`,
 `2006-01-02T15:04:05.999999999`, `2006-01-02Z07:00`, and `2006-01-02`. The local

docs/reference/commandline/import.md

@@ -47,7 +47,7 @@ Import to docker via pipe and `STDIN`.
 
     $ cat exampleimage.tgz | docker import - exampleimagelocal:new
 
-Import with a commit message
+Import with a commit message.
 
     $ cat exampleimage.tgz | docker import --message "New image imported from tarball" - exampleimagelocal:new
 

docs/reference/commandline/network_ls.md

@@ -94,7 +94,7 @@ NETWORK ID          NAME                DRIVER
 You can also filter for a substring in a name as this shows:
 
 ```bash
-$ docker ps --filter name=foo
+$ docker network ls --filter name=foo
 NETWORK ID          NAME                DRIVER
 95e74588f40d        foo                 bridge
 06e7eef0a170        foobar              bridge
@@ -104,8 +104,8 @@ NETWORK ID          NAME                DRIVER
 
 The `id` filter matches on all or part of a network's ID.
 
-The following filter matches all networks with a name containing the
-`06e7eef01700` string.
+The following filter matches all networks with an ID containing the
+`63d1ff1f77b0...` string.
 
 ```bash
 $ docker network ls --filter id=63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161
@@ -113,14 +113,14 @@ NETWORK ID          NAME                DRIVER
 63d1ff1f77b0        dev                 bridge
 ```
 
-You can also filter for a substring in a ID as this shows:
+You can also filter for a substring in an ID as this shows:
 
 ```bash
-$ docker ps --filter id=95e74588f40d
+$ docker network ls --filter id=95e74588f40d
 NETWORK ID          NAME                DRIVER
 95e74588f40d        foo                 bridge
 
-$ docker ps --filter id=95e
+$ docker network ls --filter id=95e
 NETWORK ID          NAME                DRIVER
 95e74588f40d        foo                 bridge
 ```

docs/reference/commandline/network_rm.md

@@ -25,7 +25,7 @@ To remove the network named 'my-network':
 ```
 
 To delete multiple networks in a single `docker network rm` command, provide
-multiple network names or id's. The following example deletes a network with id
+multiple network names or ids. The following example deletes a network with id
 `3695c422697f` and a network named `my-network`:
 
 ```bash

docs/reference/commandline/rm.md

@@ -46,15 +46,15 @@ This command will delete all stopped containers. The command
 the `rm` command which will delete them. Any running containers will not be
 deleted.
 
-  $ docker rm -v redis
-  redis
+    $ docker rm -v redis
+    redis
 
 This command will remove the container and any volumes associated with it.
 Note that if a volume was specified with a name, it will not be removed.
 
-  $ docker create -v awesome:/foo -v /bar --name hello redis
-  hello
-  $ docker rm -v hello
+    $ docker create -v awesome:/foo -v /bar --name hello redis
+    hello
+    $ docker rm -v hello
 
 In this example, the volume for `/foo` will remain intact, but the volume for
 `/bar` will be removed. The same behavior holds for volumes inherited with