Update tag documentation regarding 'alias' usage

The word `alias` is not very common when speaking about image names and
tags. So we just refer to image name as the overall identifier of an
image.

Signed-off-by: Sascha Grunert <sgrunert@suse.com>
This commit is contained in:
Sascha Grunert 2019-12-17 11:28:07 +01:00
parent 74b89da27c
commit 38ba9e6922
No known key found for this signature in database
GPG key ID: 8CE029DD1A866E52
2 changed files with 9 additions and 7 deletions

View file

@ -12,7 +12,7 @@ var (
tagDescription = "Adds one or more additional names to locally-stored image."
_tagCommand = &cobra.Command{
Use: "tag [flags] IMAGE TAG [TAG...]",
Use: "tag [flags] IMAGE TARGET_NAME [TARGET_NAME...]",
Short: "Add an additional name to a local image",
Long: tagDescription,
RunE: func(cmd *cobra.Command, args []string) error {
@ -51,7 +51,7 @@ func tagCmd(c *cliconfig.TagValues) error {
for _, tagName := range args[1:] {
if err := newImage.TagImage(tagName); err != nil {
return errors.Wrapf(err, "error adding '%s' to image %q", tagName, newImage.InputName)
return errors.Wrapf(err, "error adding %q to image %q", tagName, newImage.InputName)
}
}
return nil

View file

@ -4,14 +4,15 @@
podman\-tag - Add an additional name to a local image
## SYNOPSIS
**podman tag** *image*[:*tag*] *target-name*[:*tag*] [*options*]
**podman tag** *image*[:*tag*] [*target-name*[:*tag*]...] [*options*]
**podman image tag** *image*[:*tag*] *target-name*[:*tag*] [*options*]
**podman image tag** *image*[:*tag*] [*target-name*[:*tag*]...] [*options*]
## DESCRIPTION
Assigns a new alias to an image. An alias refers to the entire image name, including the optional
*tag* after the `:`. If you do not provide *tag*, podman will default to `latest` for both
the *image* and the *target-name*.
Assigns a new image name to an existing image. A full name refers to the entire
image name, including the optional *tag* after the `:`. If there is no *tag*
provided, then podman will default to `latest` for both the *image* and the
*target-name*.
## OPTIONS
@ -32,4 +33,5 @@ $ podman tag httpd myregistryhost:5000/fedora/httpd:v2
podman(1)
## HISTORY
December 2019, Update description to refer to 'name' instead of 'alias' by Sascha Grunert <sgrunert@suse.com>
July 2017, Originally compiled by Ryan Cole <rycole@redhat.com>