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] [-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 34Author 35------ 36Written by Linus Torvalds <torvalds@osdl.org>, 37Junio C Hamano <junkio@cox.net> and Chris Wright <chrisw@osdl.org>. 38 39Documentation 40-------------- 41Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>. 42 43GIT 44--- 45Part of the gitlink:git[7] suite