'\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH gbp-tag 1 "15 December 2023" "" "git-buildpackage Manual"
.SH NAME
gbp-tag \- Tag a Debian packages in a Git repository
.SH SYNOPSIS
'nh
.fi
.ad l
\*(T<\fBgbp tag\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\*(T<\fB\-\-version\fR\*(T>] [\*(T<\fB\-\-help\fR\*(T>] [\*(T<\fB\-\-verbose\fR\*(T>] [\*(T<\fB\-\-color=\fR\*(T>[auto|on|off]] [\*(T<\fB\-\-color\-scheme=\fR\*(T> \fICOLOR_SCHEME\fR] [\*(T<\fB\-\-ignore\-branch\fR\*(T>] [\*(T<\fB\-\-[no\-]ignore\-new\fR\*(T>] [\*(T<\fB\-\-[no\-]sign\-tags\fR\*(T>] [\*(T<\fB\-\-keyid=\fR\*(T> \fIGPG-KEYID\fR] [\*(T<\fB\-\-debian\-branch=\fR\*(T> \fIBRANCH_NAME\fR] [\*(T<\fB\-\-debian\-tag=\fR\*(T> \fItag-format\fR] [\*(T<\fB\-\-debian\-tag\-msg=\fR\*(T> \fItag-msg-format\fR] [\*(T<\fB\-\-posttag=\fR\*(T> \fICOMMAND\fR] [\*(T<\fB\-\-retag\fR\*(T>]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBgbp tag\fR tags the current head commit appropriately. It will in order:
.TP 0.2i
\(bu
Verify that it is being executed from the Debian branch.
.TP 0.2i
\(bu
Verify that the repository doesn't contain any uncommitted source
changes.
.TP 0.2i
\(bu
Create a git tag using the information from \*(T<\fIdebian/changelog\fR\*(T>.
.TP 0.2i
\(bu
(Optionally) call a post tag hook.
.SH OPTIONS
.TP 
\*(T<\fB\-\-version\fR\*(T>
Print version of the program, i.e. version of the git-buildpackage
suite
.TP 
\*(T<\fB\-v\fR\*(T>, \*(T<\fB\-\-verbose\fR\*(T>
Verbose execution
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
Print help and exit
.TP 
\*(T<\fB\-\-color=\fR\*(T>[auto|on|off] 
Whether to use colored output.
.TP 
\*(T<\fB\-\-color\-scheme=\fR\*(T>\fICOLOR_SCHEME\fR 
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,
\*(T<\fB\-\-git\-color\-scheme=\fR\*(T>\*(T<'cyan:34::'\*(T> would
show debug messages in cyan, info messages in blue and other messages
in default (i.e. warning and error messages in red).
.TP 
\*(T<\fB\-\-posttag=\fR\*(T>\fICOMMAND\fR 
Execute \fICOMMAND\fR after creating the tag.

Exported environment variables are: \fBGBP_TAG\fR (the name
of the generated tag), \fBGBP_BRANCH\fR (the branch the
package was built from) and \fBGBP_SHA1\fR (the sha1 of the
commit the tag was created at).
.TP 
\*(T<\fB\-\-[no\-]sign\-tags\fR\*(T> 
GPG sign all created tags.
.TP 
\*(T<\fB\-\-keyid=\fR\*(T>\fIGPG-KEYID\fR 
Use this keyid for gpg signing tags.
.TP 
\*(T<\fB\-\-debian\-tag=\fR\*(T>\fITAG-FORMAT\fR 
Use this tag format when tagging Debian versions, default is
\fIdebian/%(version)s\fR.
.TP 
\*(T<\fB\-\-debian\-tag\-msg=\fR\*(T>\fItag-msg-format\fR 
Use this tag message format when signing Debian versions,
default is \fI%(pkg)s Debian release %(version)s\fR
.TP 
\*(T<\fB\-\-retag\fR\*(T> 
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 \*(T<\fIgbp.conf\fR\*(T>.
.TP 
\*(T<\fB\-\-debian\-branch\fR\*(T>=\fIBRANCH_NAME\fR 
If you're not on this branch when invoking \fBgbp tag\fR it will
fail. Default is \fImaster\fR. 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
\*(T<\fB\-\-ignore\-branch\fR\*(T>.
.TP 
\*(T<\fB\-\-ignore\-branch\fR\*(T> 
Don't check if the current branch matches
\fIDEBIAN-BRANCH\fR.
.TP 
\*(T<\fB\-\-[no\-]ignore\-new\fR\*(T> 
Don't abort if there are uncommitted changes in the source tree or
the current branch doesn't match the
\fIDEBIAN-BRANCH\fR.
.SH EXAMPLES
Create a tag with the current defaults
.PP
.nf
\*(T<
      \fBgbp tag\fR
    \*(T>
.fi
.PP
Create using a more upstreamish tag format:
.PP
.nf
\*(T<
      \fBgbp tag\fR \-\-debian\-tag='v%(version)s'
    \*(T>
.fi
.SH "CONFIGURATION FILES"
Several \*(T<\fIgbp.conf\fR\*(T> files are parsed 
to set defaults for the above command-line arguments. See the
\fBgbp.conf\fR(5) manpage for details.
.SH "SEE ALSO"
\fBgbp-buildpackage\fR(1),
\fBgbp-push\fR(1),
\fBgbp.conf\fR(5),
.SH AUTHOR
Guido G\(:unther <\*(T<agx@sigxcpu.org\*(T>>