{"thread":{"id":"14651","subject":"[PATCH] document that git-tag can tag more than heads","startedAt":"2008-07-24T05:01:34Z","lastAt":"2008-07-24T16:55:25Z","messageCount":3,"participants":["Jonathan Nieder","Kalle Olavi Niemitalo"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"84670","messageId":"Pine.GSO.4.62.0807240000470.23113@harper.uchicago.edu","threadId":"14651","inReplyTo":null,"subject":"[PATCH] document that git-tag can tag more than heads","fromName":"Jonathan Nieder","fromEmail":"jrnieder@uchicago.edu","sentAt":"2008-07-24T05:01:34Z","receivedAt":"2008-07-24T05:01:34Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"After looking the git-tag manpage, someone on #git wondered how\nto tag a commit that is not a branch head.  This patch changes\nthe synopsis to say \"<commit-ish> | <object>\" instead of\n\"<head>\" to address his question.\n\nSamuel Bronson had the idea of putting \"<commit-ish> | <object>\"\nfor \"<object>\" because most tags point to commits (and for the\nrest of the manpage, all tags point to commits).\n\nSigned-off-by: Jonathan Nieder <jrnieder@uchicago.edu>\n---\n Documentation/git-tag.txt |    3 ++-\n 1 files changed, 2 insertions(+), 1 deletions(-)\n\ndiff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt\nindex b8dc88f..1ce1d7d 100644\n--- a/Documentation/git-tag.txt\n+++ b/Documentation/git-tag.txt\n@@ -9,7 +9,8 @@ git-tag - Create, list, delete or verify a tag object signed with GPG\n SYNOPSIS\n --------\n [verse]\n-'git tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>]  <name> [<head>]\n+'git tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>]\n+\t<name> [<commit-ish> | <object>]\n 'git tag' -d <name>...\n 'git tag' [-n[<num>]] -l [<pattern>]\n 'git tag' -v <name>...\n-- \n1.5.6.3.549.g8ca11\n"},{"id":"84690","messageId":"87prp3652z.fsf@Astalo.kon.iki.fi","threadId":"14651","inReplyTo":"Pine.GSO.4.62.0807240000470.23113@harper.uchicago.edu","subject":"Re: [PATCH] document that git-tag can tag more than heads","fromName":"Kalle Olavi Niemitalo","fromEmail":"kon@iki.fi","sentAt":"2008-07-24T08:48:04Z","receivedAt":"2008-07-24T08:48:04Z","isPatch":true,"sender":{"key":"kon@iki.fi","avatar":null},"body":"Jonathan Nieder <jrnieder@uchicago.edu> writes:\n\n> Samuel Bronson had the idea of putting \"<commit-ish> | <object>\"\n> for \"<object>\" because most tags point to commits (and for the\n> rest of the manpage, all tags point to commits).\n\nBut the argument is not a <commit-ish>.  git.txt says:\n\n        A command that takes a <commit-ish> argument ultimately\n\twants to operate on a <commit> object but automatically\n\tdereferences <tag> objects that point at a <commit>.\n\ngit-tag does not automatically dereference tag objects that\npoint to a commit.  So if you want to use \"|\", then it should be\n\"<commit> | <object>\".\n"},{"id":"84745","messageId":"Pine.GSO.4.62.0807241148210.14325@harper.uchicago.edu","threadId":"14651","inReplyTo":"87prp3652z.fsf@Astalo.kon.iki.fi","subject":"[PATCH v2] document that git-tag can tag more than heads","fromName":"Jonathan Nieder","fromEmail":"jrnieder@uchicago.edu","sentAt":"2008-07-24T16:55:25Z","receivedAt":"2008-07-24T16:55:25Z","isPatch":true,"sender":{"key":"jrnieder@gmail.com","avatar":"https://avatars.githubusercontent.com/u/281595?v=4"},"body":"After looking the git-tag manpage, someone on #git wondered how\nto tag a commit that is not a branch head.  This patch changes\nthe synopsis to say \"<commit> | <object>\" instead of \"<head>\" to\naddress his question.\n\nSamuel Bronson had the idea of putting \"<commit> | <object>\"\nfor \"<object>\" because most tags point to commits (and for the\nrest of the manpage, all tags point to commits).\n\nSigned-off-by: Jonathan Nieder <jrnieder@uchicago.edu>\n---\n Kalle Olavi Niemitalo wrote:\n\n > git-tag does not automatically dereference tag objects that\n > point to a commit.  So if you want to use \"|\", then it should be\n > \"<commit> | <object>\".\n\n Nice catch -- thanks.\n\n Documentation/git-tag.txt |    3 ++-\n 1 files changed, 2 insertions(+), 1 deletions(-)\n\ndiff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt\nindex b8dc88f..046ab35 100644\n--- a/Documentation/git-tag.txt\n+++ b/Documentation/git-tag.txt\n@@ -9,7 +9,8 @@ git-tag - Create, list, delete or verify a tag object signed with GPG\n SYNOPSIS\n --------\n [verse]\n-'git tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>]  <name> [<head>]\n+'git tag' [-a | -s | -u <key-id>] [-f] [-m <msg> | -F <file>]\n+\t<name> [<commit> | <object>]\n 'git tag' -d <name>...\n 'git tag' [-n[<num>]] -l [<pattern>]\n 'git tag' -v <name>...\n-- \n1.5.6.3.549.g8ca11\n"}]}