man1/git-tag.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "GIT-TAG" 1 "" "" ""
  21 .SH NAME
  22 git-tag \- Create a tag object signed with GPG
  23 .SH "SYNOPSIS"
  24
  25
  26 git\-tag [\-a | \-s | \-u <key\-id>] [\-f | \-d] [\-m <msg>] <name> [<head>]
  27
  28 .SH "DESCRIPTION"
  29
  30
  31 Adds a tag reference in \&.git/refs/tags/
  32
  33
  34 Unless \-f is given, the tag must not yet exist in \&.git/refs/tags/ directory\&.
  35
  36
  37 If one of \-a, \-s, or \-u <key\-id> is passed, the command creates a tag object, and requires the tag message\&. Unless \-m <msg> is given, an editor is started for the user to type in the tag message\&.
  38
  39
  40 Otherwise just the SHA1 object name of the commit object is written (i\&.e\&. a lightweight tag)\&.
  41
  42
  43 A GnuPG signed tag object will be created when \-s or \-u <key\-id> is used\&. When \-u <key\-id> is not used, the committer identity for the current user is used to find the GnuPG key for signing\&.
  44
  45
  46 \-d <tag> deletes the tag\&.
  47
  48 .SH "OPTIONS"
  49
  50 .TP
  51 \-a
  52 Make an unsigned, annotated tag object
  53
  54 .TP
  55 \-s
  56 Make a GPG\-signed tag, using the default e\-mail address's key
  57
  58 .TP
  59 \-u <key\-id>
  60 Make a GPG\-signed tag, using the given key
  61
  62 .TP
  63 \-f
  64 Replace an existing tag with the given name (instead of failing)
  65
  66 .TP
  67 \-d
  68 Delete an existing tag with the given name
  69
  70 .TP
  71 \-m <msg>
  72 Use the given tag message (instead of prompting)
  73
  74 .SH "AUTHOR"
  75
  76
  77 Written by Linus Torvalds <torvalds@osdl\&.org>, Junio C Hamano <junkio@cox\&.net> and Chris Wright <chrisw@osdl\&.org>\&.
  78
  79 .SH "DOCUMENTATION"
  80
  81
  82 Documentation by David Greaves, Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
  83
  84 .SH "GIT"
  85
  86
  87 Part of the \fBgit\fR(7) suite
  88