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