Browse code

Unify docker commands' usage in man and help

Signed-off-by: Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>

Ma Shimiao authored on 2015/06/09 22:33:41
Showing 10 changed files
... ...
@@ -16,7 +16,7 @@ import (
16 16
 //
17 17
 // Usage: docker cp CONTAINER:PATH HOSTDIR
18 18
 func (cli *DockerCli) CmdCp(args ...string) error {
19
-	cmd := cli.Subcmd("cp", []string{"CONTAINER:PATH HOSTDIR|-"}, "Copy files/folders from a PATH on the container to a HOSTDIR on the host\nrunning the command. Use '-' to write the data as a tar file to STDOUT.", true)
19
+	cmd := cli.Subcmd("cp", []string{"CONTAINER:PATH HOSTDIR|-"}, "Copy files/folders from a container's PATH to a HOSTDIR on the host\nrunning the command. Use '-' to write the data as a tar file to STDOUT.", true)
20 20
 	cmd.Require(flag.Exact, 2)
21 21
 
22 22
 	cmd.ParseFlags(args, true)
... ...
@@ -14,7 +14,7 @@ import (
14 14
 //
15 15
 // Usage: docker export [OPTIONS] CONTAINER
16 16
 func (cli *DockerCli) CmdExport(args ...string) error {
17
-	cmd := cli.Subcmd("export", []string{"CONTAINER"}, "Export a filesystem as a tar archive (streamed to STDOUT by default)", true)
17
+	cmd := cli.Subcmd("export", []string{"CONTAINER"}, "Export the contents of a container's filesystem as a tar archive", true)
18 18
 	outfile := cmd.String([]string{"o", "-output"}, "", "Write to a file, instead of STDOUT")
19 19
 	cmd.Require(flag.Exact, 1)
20 20
 
... ...
@@ -15,7 +15,7 @@ import (
15 15
 //
16 16
 // Usage: docker pull [OPTIONS] IMAGENAME[:TAG|@DIGEST]
17 17
 func (cli *DockerCli) CmdPull(args ...string) error {
18
-	cmd := cli.Subcmd("pull", []string{"NAME[:TAG|@DIGEST]"}, "Pull an image or a repository from the registry", true)
18
+	cmd := cli.Subcmd("pull", []string{"NAME[:TAG|@DIGEST]"}, "Pull an image or a repository from a registry", true)
19 19
 	allTags := cmd.Bool([]string{"a", "-all-tags"}, false, "Download all tagged images in the repository")
20 20
 	cmd.Require(flag.Exact, 1)
21 21
 
... ...
@@ -13,7 +13,7 @@ import (
13 13
 //
14 14
 // Usage: docker push NAME[:TAG]
15 15
 func (cli *DockerCli) CmdPush(args ...string) error {
16
-	cmd := cli.Subcmd("push", []string{"NAME[:TAG]"}, "Push an image or a repository to the registry", true)
16
+	cmd := cli.Subcmd("push", []string{"NAME[:TAG]"}, "Push an image or a repository to a registry", true)
17 17
 	cmd.Require(flag.Exact, 1)
18 18
 
19 19
 	cmd.ParseFlags(args, true)
... ...
@@ -32,40 +32,40 @@ var (
32 32
 		{"attach", "Attach to a running container"},
33 33
 		{"build", "Build an image from a Dockerfile"},
34 34
 		{"commit", "Create a new image from a container's changes"},
35
-		{"cp", "Copy files/folders from a container's filesystem to the host path"},
35
+		{"cp", "Copy files/folders from a container to a HOSTDIR or to STDOUT"},
36 36
 		{"create", "Create a new container"},
37 37
 		{"diff", "Inspect changes on a container's filesystem"},
38 38
 		{"events", "Get real time events from the server"},
39 39
 		{"exec", "Run a command in a running container"},
40
-		{"export", "Stream the contents of a container as a tar archive"},
40
+		{"export", "Export a container's filesystem as a tar archive"},
41 41
 		{"history", "Show the history of an image"},
42 42
 		{"images", "List images"},
43
-		{"import", "Create a new filesystem image from the contents of a tarball"},
43
+		{"import", "Import the contents from a tarball to create a filesystem image"},
44 44
 		{"info", "Display system-wide information"},
45 45
 		{"inspect", "Return low-level information on a container or image"},
46 46
 		{"kill", "Kill a running container"},
47
-		{"load", "Load an image from a tar archive"},
48
-		{"login", "Register or log in to a Docker registry server"},
49
-		{"logout", "Log out from a Docker registry server"},
47
+		{"load", "Load an image from a tar archive or STDIN"},
48
+		{"login", "Register or log in to a Docker registry"},
49
+		{"logout", "Log out from a Docker registry"},
50 50
 		{"logs", "Fetch the logs of a container"},
51
-		{"port", "Lookup the public-facing port that is NAT-ed to PRIVATE_PORT"},
51
+		{"port", "List port mappings or a specific mapping for the CONTAINER"},
52 52
 		{"pause", "Pause all processes within a container"},
53 53
 		{"ps", "List containers"},
54
-		{"pull", "Pull an image or a repository from a Docker registry server"},
55
-		{"push", "Push an image or a repository to a Docker registry server"},
56
-		{"rename", "Rename an existing container"},
54
+		{"pull", "Pull an image or a repository from a registry"},
55
+		{"push", "Push an image or a repository to a registry"},
56
+		{"rename", "Rename a container"},
57 57
 		{"restart", "Restart a running container"},
58 58
 		{"rm", "Remove one or more containers"},
59 59
 		{"rmi", "Remove one or more images"},
60 60
 		{"run", "Run a command in a new container"},
61
-		{"save", "Save an image to a tar archive"},
62
-		{"search", "Search for an image on the Docker Hub"},
63
-		{"start", "Start a stopped container"},
64
-		{"stats", "Display a stream of a containers' resource usage statistics"},
61
+		{"save", "Save an image(s) to a tar archive"},
62
+		{"search", "Search the Docker Hub for images"},
63
+		{"start", "Start one or more stopped containers"},
64
+		{"stats", "Display a live stream of container(s) resource usage statistics"},
65 65
 		{"stop", "Stop a running container"},
66 66
 		{"tag", "Tag an image into a repository"},
67
-		{"top", "Lookup the running processes of a container"},
68
-		{"unpause", "Unpause a paused container"},
67
+		{"top", "Display the running processes of a container"},
68
+		{"unpause", "Unpause all processes within a container"},
69 69
 		{"version", "Show the Docker version information"},
70 70
 		{"wait", "Block until a container stops, then print its exit code"},
71 71
 	}
... ...
@@ -13,7 +13,7 @@ weight=1
13 13
 
14 14
     Usage: docker load [OPTIONS]
15 15
 
16
-    Load an image from a tar archive on STDIN
16
+    Load an image from a tar archive or STDIN
17 17
 
18 18
       -i, --input=""     Read from a tar archive file, instead of STDIN
19 19
 
... ...
@@ -2,7 +2,7 @@
2 2
 % Docker Community
3 3
 % JUNE 2014
4 4
 # NAME
5
-docker-export - Export the contents of a filesystem as a tar archive to STDOUT
5
+docker-export - Export the contents of a container's filesystem as a tar archive
6 6
 
7 7
 # SYNOPSIS
8 8
 **docker export**
... ...
@@ -2,7 +2,7 @@
2 2
 % Docker Community
3 3
 % JUNE 2014
4 4
 # NAME
5
-docker-load - Load an image from a tar archive on STDIN
5
+docker-load - Load an image from a tar archive or STDIN
6 6
 
7 7
 # SYNOPSIS
8 8
 **docker load**
... ...
@@ -2,7 +2,7 @@
2 2
 % Docker Community
3 3
 % JUNE 2014
4 4
 # NAME
5
-docker-logout - Log out from a Docker Registry.
5
+docker-logout - Log out from a Docker registry.
6 6
 
7 7
 # SYNOPSIS
8 8
 **docker logout**
... ...
@@ -11,7 +11,7 @@ CONTAINER [ps OPTIONS]
11 11
 
12 12
 # DESCRIPTION
13 13
 
14
-Look up the running process of the container. ps-OPTION can be any of the
14
+Display the running process of the container. ps-OPTION can be any of the
15 15
  options you would pass to a Linux ps command.
16 16
 
17 17
 # OPTIONS
... ...
@@ -31,3 +31,4 @@ Run **docker top** with the ps option of -x:
31 31
 April 2014, Originally compiled by William Henry (whenry at redhat dot com)
32 32
 based on docker.com source material and internal work.
33 33
 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
34
+June 2015, updated by Ma Shimiao <mashimiao.fnst@cn.fujitsu.com>