@@ -25,7 +25,7 @@ func newSecretCreateCommand(dockerCli *command.DockerCli) *cobra.Command {

 	}

 	cmd := &cobra.Command{

-		Use:   "create [name]",

+		Use:   "create [OPTIONS] SECRET [SECRET...]",

 		Short: "Create a secret using stdin as content",

 		Args:  cli.RequiresMinArgs(1),

 		RunE: func(cmd *cobra.Command, args []string) error {

@@ -16,8 +16,8 @@ type inspectOptions struct {

 func newSecretInspectCommand(dockerCli *command.DockerCli) *cobra.Command {

 	opts := inspectOptions{}

 	cmd := &cobra.Command{

-		Use:   "inspect SECRET [SECRET]",

-		Short: "Inspect a secret",

+		Use:   "inspect [OPTIONS] SECRET [SECRET...]",

+		Short: "Display detailed information on one or more secrets",

 		Args:  cli.RequiresMinArgs(1),

 		RunE: func(cmd *cobra.Command, args []string) error {

 			opts.names = args

@@ -21,7 +21,7 @@ func newSecretListCommand(dockerCli *command.DockerCli) *cobra.Command {

 	opts := listOptions{}

 	cmd := &cobra.Command{

-		Use:   "ls",

+		Use:   "ls [OPTIONS]",

 		Short: "List secrets",

 		Args:  cli.NoArgs,

 		RunE: func(cmd *cobra.Command, args []string) error {

@@ -15,8 +15,8 @@ type removeOptions struct {

 func newSecretRemoveCommand(dockerCli *command.DockerCli) *cobra.Command {

 	return &cobra.Command{

-		Use:   "rm SECRET [SECRET]",

-		Short: "Remove a secret",

+		Use:   "rm SECRET [SECRET...]",

+		Short: "Remove one or more secrets",

 		Args:  cli.RequiresMinArgs(1),

 		RunE: func(cmd *cobra.Command, args []string) error {

 			opts := removeOptions{

@@ -16,7 +16,7 @@ keywords: ["secret, create"]

 # secret create

 ```Markdown

-Usage:  docker secret create [NAME]

+Usage:  docker secret create [OPTIONS] SECRET

 Create a secret using stdin as content

 Options:

@@ -76,5 +76,3 @@ $ docker secret inspect secret.json

 * [secret inspect](secret_inspect.md)

 * [secret ls](secret_ls.md)

 * [secret rm](secret_rm.md)

-

-<style>table tr > td:first-child { white-space: nowrap;}</style>