Merge pull request #3454 from jsternberg/buildx-tag-help

docs: clarify cli help for the `--tag` option

Author: tonistiigi

commands/build.go

@@ -551,7 +551,7 @@ func buildCmd(dockerCli command.Cli, rootOpts *rootOptions, debugger debuggerOpt
 
 	flags.StringArrayVar(&options.ssh, "ssh", []string{}, `SSH agent socket or keys to expose to the build (format: "default|<id>[=<socket>|<key>[,<key>]]")`)
 
-	flags.StringArrayVarP(&options.tags, "tag", "t", []string{}, `Name and optionally a tag (format: "name:tag")`)
+	flags.StringArrayVarP(&options.tags, "tag", "t", []string{}, `Image identifier (format: "[registry/]repository[:tag]")`)
 
 	flags.StringVar(&options.target, "target", "", "Set the target build stage to build")
 

docs/reference/buildx_build.md

@@ -47,7 +47,7 @@ Start a build
 | [`--secret`](#secret)                   | `stringArray` |           | Secret to expose to the build (format: `id=mysecret[,src=/local/secret]`)                                             |
 | [`--shm-size`](#shm-size)               | `bytes`       | `0`       | Shared memory size for build containers                                                                               |
 | [`--ssh`](#ssh)                         | `stringArray` |           | SSH agent socket or keys to expose to the build (format: `default\|<id>[=<socket>\|<key>[,<key>]]`)                   |
-| [`-t`](#tag), [`--tag`](#tag)           | `stringArray` |           | Name and optionally a tag (format: `name:tag`)                                                                        |
+| [`-t`](#tag), [`--tag`](#tag)           | `stringArray` |           | Image identifier (format: `[registry/]repository[:tag]`)                                                              |
 | [`--target`](#target)                   | `string`      |           | Set the target build stage to build                                                                                   |
 | [`--ulimit`](#ulimit)                   | `ulimit`      |           | Ulimit options                                                                                                        |
 

docs/reference/buildx_dap_build.md

@@ -39,7 +39,7 @@ Start a build
 | `--secret`          | `stringArray` |           | Secret to expose to the build (format: `id=mysecret[,src=/local/secret]`)                                             |
 | `--shm-size`        | `bytes`       | `0`       | Shared memory size for build containers                                                                               |
 | `--ssh`             | `stringArray` |           | SSH agent socket or keys to expose to the build (format: `default\|<id>[=<socket>\|<key>[,<key>]]`)                   |
-| `-t`, `--tag`       | `stringArray` |           | Name and optionally a tag (format: `name:tag`)                                                                        |
+| `-t`, `--tag`       | `stringArray` |           | Image identifier (format: `[registry/]repository[:tag]`)                                                              |
 | `--target`          | `string`      |           | Set the target build stage to build                                                                                   |
 | `--ulimit`          | `ulimit`      |           | Ulimit options                                                                                                        |
 

docs/reference/buildx_debug_build.md

@@ -43,7 +43,7 @@ Start a build
 | `--secret`          | `stringArray` |           | Secret to expose to the build (format: `id=mysecret[,src=/local/secret]`)                                             |
 | `--shm-size`        | `bytes`       | `0`       | Shared memory size for build containers                                                                               |
 | `--ssh`             | `stringArray` |           | SSH agent socket or keys to expose to the build (format: `default\|<id>[=<socket>\|<key>[,<key>]]`)                   |
-| `-t`, `--tag`       | `stringArray` |           | Name and optionally a tag (format: `name:tag`)                                                                        |
+| `-t`, `--tag`       | `stringArray` |           | Image identifier (format: `[registry/]repository[:tag]`)                                                              |
 | `--target`          | `string`      |           | Set the target build stage to build                                                                                   |
 | `--ulimit`          | `ulimit`      |           | Ulimit options                                                                                                        |