From: Pieter de Bie Date: Mon, 24 Mar 2008 15:11:45 GMT Subject: [PATCH] Documentation/git-tag.txt: Clarify tagging of objects Message-ID: <1206371505-7698-1-git-send-email-pdebie@ai.rug.nl> Change the synopsis and description of git-tag to reflect that any object can be tagged, not just a committish. --- This surprised me, so I guess the documentation deserves some attention. I'm only able to build the HTML documentation, so I hope this looks correct in manpages too. - Pieter Documentation/git-tag.txt | 11 ++++++++--- 1 files changed, 8 insertions(+), 3 deletions(-) diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt index b62a3d1..9702f2f 100644 --- a/Documentation/git-tag.txt +++ b/Documentation/git-tag.txt @@ -9,7 +9,7 @@ git-tag - Create, list, delete or verify a tag object signed with GPG SYNOPSIS -------- [verse] -'git-tag' [-a | -s | -u ] [-f] [-m | -F ] [] +'git-tag' [-a | -s | -u ] [-f] [-m | -F ] [] 'git-tag' -d ... 'git-tag' [-n []] -l [] 'git-tag' -v ... @@ -18,6 +18,11 @@ DESCRIPTION ----------- Adds a 'tag' reference in `.git/refs/tags/` +If `` is given, the given object will be tagged. While +this usually is a committish, other objects may be tagged +as well. If `` is not given, the current HEAD will be +tagged. + Unless `-f` is given, the tag must not yet exist in `.git/refs/tags/` directory. @@ -26,8 +31,8 @@ creates a 'tag' object, and requires the tag message. Unless `-m ` or `-F ` is given, an editor is started for the user to type in the tag message. -Otherwise just the SHA1 object name of the commit object is -written (i.e. a lightweight tag). +Otherwise just the SHA1 object name of the object is written +(i.e. a lightweight tag). A GnuPG signed tag object will be created when `-s` or `-u ` is used. When `-u ` is not used, the -- 1.5.4.4.594.g91c25