浏览代码

Modify short and flags for docker inspect

Signed-off-by: yuexiao-wang <wang.yuexiao@zte.com.cn>
yuexiao-wang 8 年之前
父节点
当前提交
cc03984e17
共有 3 个文件被更改,包括 13 次插入11 次删除
  1. 6 3
      cli/command/system/inspect.go
  2. 2 3
      docs/reference/commandline/inspect.md
  3. 5 5
      man/docker-inspect.1.md

+ 6 - 3
cli/command/system/inspect.go

@@ -25,9 +25,12 @@ func NewInspectCommand(dockerCli *command.DockerCli) *cobra.Command {
 	var opts inspectOptions
 	var opts inspectOptions
 
 
 	cmd := &cobra.Command{
 	cmd := &cobra.Command{
-		Use:   "inspect [OPTIONS] CONTAINER|IMAGE|TASK [CONTAINER|IMAGE|TASK...]",
-		Short: "Return low-level information on a container, image or task",
-		Args:  cli.RequiresMinArgs(1),
+		Use: "inspect [OPTIONS] NAME|ID [NAME|ID...]",
+		Short: strings.Join([]string{
+			"Return low-level information on Docker object(s) (e.g. container, image, volume,",
+			"\nnetwork, node, service, or task) identified by name or ID",
+		}, ""),
+		Args: cli.RequiresMinArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
 		RunE: func(cmd *cobra.Command, args []string) error {
 			opts.ids = args
 			opts.ids = args
 			return runInspect(dockerCli, opts)
 			return runInspect(dockerCli, opts)

+ 2 - 3
docs/reference/commandline/inspect.md

@@ -13,14 +13,13 @@ parent = "smn_cli"
 ```markdown
 ```markdown
 Usage:  docker inspect [OPTIONS] NAME|ID [NAME|ID...]
 Usage:  docker inspect [OPTIONS] NAME|ID [NAME|ID...]
 
 
-Return low-level information on one or multiple containers, images, volumes,
-networks, nodes, services, or tasks identified by name or ID.
+Return low-level information on Docker object(s) (e.g. container, image, volume,
+network, node, service, or task) identified by name or ID
 
 
 Options:
 Options:
   -f, --format       Format the output using the given go template
   -f, --format       Format the output using the given go template
       --help         Print usage
       --help         Print usage
   -s, --size         Display total file sizes if the type is container
   -s, --size         Display total file sizes if the type is container
-                     values are "image" or "container" or "task
       --type         Return JSON for specified type
       --type         Return JSON for specified type
 ```
 ```
 
 

+ 5 - 5
man/docker-inspect.1.md

@@ -14,8 +14,8 @@ NAME|ID [NAME|ID...]
 
 
 # DESCRIPTION
 # DESCRIPTION
 
 
-This displays all the information available in Docker for one or multiple given
-containers, images, volumes, networks, nodes, services, or tasks. By default,
+This displays the low-level information on Docker object(s) (e.g. container, 
+image, volume,network, node, service, or task) identified by name or ID. By default,
 this will render all results in a JSON array. If the container and image have
 this will render all results in a JSON array. If the container and image have
 the same name, this will return container JSON for unspecified type. If a format
 the same name, this will return container JSON for unspecified type. If a format
 is specified, the given template will be executed for each result.
 is specified, the given template will be executed for each result.
@@ -25,14 +25,14 @@ is specified, the given template will be executed for each result.
     Print usage statement
     Print usage statement
 
 
 **-f**, **--format**=""
 **-f**, **--format**=""
-    Format the output using the given Go template.
+    Format the output using the given Go template
 
 
 **-s**, **--size**
 **-s**, **--size**
-    Display total file sizes if the type is container.
+    Display total file sizes if the type is container
 
 
 **--type**=*container*|*image*|*network*|*node*|*service*|*task*|*volume*
 **--type**=*container*|*image*|*network*|*node*|*service*|*task*|*volume*
     Return JSON for specified type, permissible values are "image", "container",
     Return JSON for specified type, permissible values are "image", "container",
-    "network", "node", "service", "task", and "volume".
+    "network", "node", "service", "task", and "volume"
 
 
 # EXAMPLES
 # EXAMPLES