git.oblomov.eu Git - git/blob - Documentation/git-tag.txt

   1 git-tag(1)
   2 ==========
   3
   4 NAME
   5 ----
   6 git-tag -  Create a tag object signed with GPG
   7
   8
   9 SYNOPSIS
  10 --------
  11 'git-tag' [-a | -s | -u <key-id>] [-f] [-m <msg>] <name> [<head>]
  12
  13 DESCRIPTION
  14 -----------
  15 Adds a 'tag' reference in .git/refs/tags/
  16
  17 Unless `-f` is given, the tag must not yet exist in
  18 `.git/refs/tags/` directory.
  19
  20 If one of `-a`, `-s`, or `-u <key-id>` is passed, the command
  21 creates a 'tag' object, and requires the tag message.  Unless
  22 `-m <msg>` is given, an editor is started for the user to type
  23 in the tag message.
  24
  25 Otherwise just the SHA1 object name of the commit object is
  26 written (i.e. an lightweight tag).
  27
  28 A GnuPG signed tag object will be created when `-s` or `-u
  29 <key-id>` is used.  When `-u <key-id>` is not used, the
  30 committer identity for the current user is used to find the
  31 GnuPG key for signing.
  32
  33
  34 Author
  35 ------
  36 Written by Linus Torvalds <torvalds@osdl.org>,
  37 Junio C Hamano <junkio@cox.net> and Chris Wright <chrisw@osdl.org>.
  38
  39 Documentation
  40 --------------
  41 Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.
  42
  43 GIT
  44 ---
  45 Part of the gitlink:git[7] suite