NAME

       gbp-tag - Tag a Debian packages in a Git repository

SYNOPSIS

       gbp tag [--version] [--help] [--verbose] [--color=[auto|on|off]] [--color-scheme=
               COLOR_SCHEME] [--ignore-branch] [--[no-]ignore-new] [--[no-]sign-tags] [--keyid=
               GPG-KEYID] [--debian-branch= BRANCH_NAME] [--debian-tag= tag-format]
               [--debian-tag-msg= tag-msg-format] [--posttag= COMMAND] [--retag]

DESCRIPTION

       gbp tag tags the current head commit appropriately. It will in order:

       • Verify that it is being executed from the Debian branch.

       • Verify that the repository doesn't contain any uncommitted source changes.

       • Create a git tag using the information from debian/changelog.

       • (Optionally) call a post tag hook.

OPTIONS

       --version
              Print version of the program, i.e. version of the git-buildpackage suite

       -v, --verbose
              Verbose execution

       -h, --help
              Print help and exit

       --color=[auto|on|off]
              Whether to use colored output.

       --color-scheme=COLOR_SCHEME
              Colors to use in output (when color is enabled). The  format  for  COLOR_SCHEME  is
              '<debug>:<info>:<warning>:<error>'.  Numerical values and color names are accepted,
              empty fields imply the default color. For  example,  --git-color-scheme='cyan:34::'
              would  show  debug  messages  in  cyan, info messages in blue and other messages in
              default (i.e. warning and error messages in red).

       --posttag=COMMAND
              Execute COMMAND after creating the tag.

              Exported environment variables are:  GBP_TAG  (the  name  of  the  generated  tag),
              GBP_BRANCH  (the  branch  the package was built from) and GBP_SHA1 (the sha1 of the
              commit the tag was created at).

       --[no-]sign-tags
              GPG sign all created tags.

       --keyid=GPG-KEYID
              Use this keyid for gpg signing tags.

       --debian-tag=TAG-FORMAT
              Use this tag format when tagging Debian versions, default is debian/%(version)s.

       --debian-tag-msg=tag-msg-format
              Use this tag message format when signing Debian versions, default is %(pkg)s Debian
              release %(version)s

       --retag
              Don't  fail tag operations if a tag with the same version already exists. This is a
              command line only option that cannot be specified via gbp.conf.

       --debian-branch=BRANCH_NAME
              If you're not on this branch when invoking gbp tag it will fail. Default is master.
              This is done to make sure you don't accidentally tag on the wrong branch. Not being
              on this branch will be ignored when using --ignore-branch.

       --ignore-branch
              Don't check if the current branch matches DEBIAN-BRANCH.

       --[no-]ignore-new
              Don't abort if there are uncommitted changes in the  source  tree  or  the  current
              branch doesn't match the DEBIAN-BRANCH.

EXAMPLES

       Create a tag with the current defaults

             gbp tag

       Create using a more upstreamish tag format:

             gbp tag --debian-tag='v%(version)s'

CONFIGURATION FILES

       Several  gbp.conf  files  are parsed to set defaults for the above command-line arguments.
       See the gbp.conf(5) manpage for details.

SEE ALSO

       gbp-buildpackage(1), gbp-push(1), gbp.conf(5),

AUTHOR

       Guido Günther <agx@sigxcpu.org>

                                        24 September 2024                              gbp-tag(1)