git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2] document that git-tag can tag more than heads

From
Jonathan Nieder <jrnieder@uchicago.edu>
Date
Jul 24, 2008, 16:55 UTC
Message-ID
<Pine.GSO.4.62.0807241148210.14325@harper.uchicago.edu>
In-Reply-To
<87prp3652z.fsf@Astalo.kon.iki.fi>

After looking the git-tag manpage, someone on #git wondered how to tag a commit that is not a branch head. This patch changes the synopsis to say "<commit> | <object>" instead of "<head>" to address his question.

Samuel Bronson had the idea of putting "<commit> | <object>" for "<object>" because most tags point to commits (and for the rest of the manpage, all tags point to commits).

Signed-off-by: Jonathan Nieder <jrnieder@uchicago.edu>
---
 Kalle Olavi Niemitalo wrote:
 > git-tag does not automatically dereference tag objects that
 > point to a commit.  So if you want to use "|", then it should be
 > "<commit> | <object>".
 Nice catch -- thanks.
 Documentation/git-tag.txt |    3 ++-
 1 files changed, 2 insertions(+), 1 deletions(-)
diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index b8dc88f..046ab35 100644
--- a/Documentation/git-tag.txt
+++ b/Documentation/git-tag.txt
@@ -9,7 +9,8 @@ git-tag - Create, list, delete or verify a tag object signed with GPG
 SYNOPSIS
 --------
 [verse]
-'git tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>]  <name> [<head>]
+'git tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>]
+	<name> [<commit> | <object>]
 'git tag' -d <name>...
 'git tag' [-n[<num>]] -l [<pattern>]
 'git tag' -v <name>...
-- 
1.5.6.3.549.g8ca11
Previous: Kalle Olavi Niemitalo
Message 3 of 3 in “document that git-tag can tag more than heads”
  1. document that git-tag can tag more than headsJonathan Nieder, Jul 24, 2008
  2. Kalle Olavi NiemitaloJul 24, 2008
  3. document that git-tag can tag more than headsJonathan Nieder, Jul 24, 2008

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.