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