projects / thirdparty / git.git / blame
| Commit | Line | Data |
|---|---|---|
| 215a7ad1 JH |
1 | git-tag(1) |
| 2 | ========== | |
| 2cf565c5 DG |
3 | |
| 4 | NAME | |
| 5 | ---- | |
| 215a7ad1 | 6 | git-tag - Create a tag object signed with GPG |
| 2cf565c5 DG |
7 | |
| 8 | ||
| 2cf565c5 DG |
9 | SYNOPSIS |
| 10 | -------- | |
| d5b0c9ea | 11 | 'git-tag' [-a | -s | -u <key-id>] [-f] [-m <msg>] <name> [<head>] |
| 2cf565c5 DG |
12 | |
| 13 | DESCRIPTION | |
| 14 | ----------- | |
| bc162e40 | 15 | Adds a 'tag' reference in .git/refs/tags/ |
| b7e438f9 | 16 | |
| bc162e40 LT |
17 | Unless `-f` is given, the tag must not yet exist in |
| 18 | `.git/refs/tags/` directory. | |
| b7e438f9 | 19 | |
| bc162e40 LT |
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. | |
| b7e438f9 | 24 | |
| bc162e40 LT |
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. | |
| 2cf565c5 DG |
32 | |
| 33 | ||
| 34 | Author | |
| 35 | ------ | |
| 3f971fc4 JH |
36 | Written by Linus Torvalds <torvalds@osdl.org>, |
| 37 | Junio C Hamano <junkio@cox.net> and Chris Wright <chrisw@osdl.org>. | |
| 2cf565c5 DG |
38 | |
| 39 | Documentation | |
| 40 | -------------- | |
| 41 | Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. | |
| 42 | ||
| 43 | GIT | |
| 44 | --- | |
| a7154e91 | 45 | Part of the gitlink:git[7] suite |