diff options
| author | Linus Torvalds <torvalds@osdl.org> | 2005-10-06 14:10:39 -0700 |
|---|---|---|
| committer | Junio C Hamano <junkio@cox.net> | 2005-10-06 14:23:29 -0700 |
| commit | bc162e40ea6dc3208e3bda76301d6409607ed3ff (patch) | |
| tree | 036b80c3359820af7334edbef28fa2ceca0c565f /Documentation/git-tag.txt | |
| parent | 12aac5de3dd73a1f9d03f81c5b0087e71794cee7 (diff) | |
| download | git-bc162e40ea6dc3208e3bda76301d6409607ed3ff.tar.gz | |
Allow "-u" flag to tag signing
The current "git tag -s" thing always uses the tagger name as the signing
user key, which is very irritating, since my key is under my email
address, but the tagger key obviously contains the actual machine name
too.
Now, I could just use "GIT_COMMITTER_EMAIL" and force it to be my real
email, but I actually think that it's nice to see which machine I use for
my work.
So rather than force my tagger ID to have to match the gpg key name, just
support the "-u" flag to "git tag" instead. It implicitly enables signing,
since it doesn't make any sense without it. Thus:
git tag -u <gpg-key-name> <tag-name> [<tagged-object>]
will use the named gpg key for signing.
Signed-off-by: Linus Torvalds <torvalds@osdl.org>
Signed-off-by: Junio C Hamano <junkio@cox.net>
Diffstat (limited to 'Documentation/git-tag.txt')
| -rw-r--r-- | Documentation/git-tag.txt | 22 |
1 files changed, 15 insertions, 7 deletions
diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index 1e0d4f5f46..1eafeef473 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -10,19 +10,27 @@ git-tag - Create a tag object signed with GPG SYNOPSIS -------- -'git-tag' [-s | -a] [-f] <name> +'git-tag' [-a | -s | -u <key-id>] [-f] [-m <msg>] <name> DESCRIPTION ----------- -Adds a "tag" reference in .git/refs/tags/ +Adds a 'tag' reference in .git/refs/tags/ -Unless "-f" is given, the tag must not yet exist in ".git/refs/tags" +Unless `-f` is given, the tag must not yet exist in +`.git/refs/tags/` directory. -If "-s" or "-a" is passed, the user will be prompted for a tag message. -and a tag object is created. Otherwise just the SHA1 object -name of the commit object is written. +If one of `-a`, `-s`, or `-u <key-id>` is passed, the command +creates a 'tag' object, and requires the tag message. Unless +`-m <msg>` is given, an editor is started for the user to type +in the tag message. -A GnuPG signed tag object will be created when "-s" is used. +Otherwise just the SHA1 object name of the commit object is +written (i.e. an lightweight tag). + +A GnuPG signed tag object will be created when `-s` or `-u +<key-id>` is used. When `-u <key-id>` is not used, the +committer identity for the current user is used to find the +GnuPG key for signing. Author |