{"thread":{"id":"7583","subject":"[PATCH] git-tag: Document that -m/-F create tag objects, too","startedAt":"2007-04-09T12:06:32Z","lastAt":"2007-04-09T16:15:11Z","messageCount":4,"participants":["Florian Weimer","Julian Phillips"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"38930","messageId":"E1Hash0-0004rN-Mu@mid.deneb.enyo.de","threadId":"7583","inReplyTo":null,"subject":"[PATCH] git-tag: Document that -m/-F create tag objects, too","fromName":"Florian Weimer","fromEmail":"fw@deneb.enyo.de","sentAt":"2007-04-09T12:06:32Z","receivedAt":"2007-04-09T12:06:32Z","isPatch":true,"sender":{"key":"fw@deneb.enyo.de","avatar":null},"body":"And warn about the fact that lightweight tags are not normally\ntransferred by clone/fetch.\n\nSigned-off-by: Florian Weimer \n---\n Documentation/git-tag.txt | 16 +++++++++-------\n 1 files changed, 9 insertions(+), 7 deletions(-)\n\ndiff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt\nindex 70235e8..fc5f4e3 100644\n--- a/Documentation/git-tag.txt\n+++ b/Documentation/git-tag.txt\n@@ -20,13 +20,15 @@ Adds a 'tag' reference in `.git/refs/tags/`\n Unless `-f` is given, the tag must not yet exist in\n `.git/refs/tags/` directory.\n \n-If one of `-a`, `-s`, or `-u ` is passed, the command\n-creates a 'tag' object, and requires the tag message. Unless\n-`-m ` is given, an editor is started for the user to type\n-in the tag message.\n-\n-Otherwise just the SHA1 object name of the commit object is\n-written (i.e. a lightweight tag).\n+If one of `-a`, `-m `, `-F `, `-s`, or `-u ` is\n+passed, the command creates a 'tag' object. Unless `-m ` or `-F\n+` is given, an editor is started for the user to type in the tag\n+message.\n+\n+Otherwise just the SHA1 object name of the commit object is written\n+(i.e. a lightweight tag). Note that such tags are not automatically\n+copied by \"git-clone\" and \"git-fetch\", so you want to use them for\n+local tags only.\n \n A GnuPG signed tag object will be created when `-s` or `-u\n ` is used. When `-u ` is not used, the\n-- \n1.5.1\n"},{"id":"38932","messageId":"Pine.LNX.4.64.0704091554330.32490@beast.quantumfyre.co.uk","threadId":"7583","inReplyTo":"E1Hash0-0004rN-Mu@mid.deneb.enyo.de","subject":"Re: [PATCH] git-tag: Document that -m/-F create tag objects, too","fromName":"Julian Phillips","fromEmail":"julian@quantumfyre.co.uk","sentAt":"2007-04-09T14:58:31Z","receivedAt":"2007-04-09T14:58:31Z","isPatch":true,"sender":{"key":"julian@quantumfyre.co.uk","avatar":"https://avatars.githubusercontent.com/u/948888?v=4"},"body":"On Mon, 9 Apr 2007, Florian Weimer wrote:\n\n> And warn about the fact that lightweight tags are not normally\n> transferred by clone/fetch.\n\nUm ... yes, they are (in v1.5.1 at least).\n\n>\n> Signed-off-by: Florian Weimer \n> ---\n> Documentation/git-tag.txt | 16 +++++++++-------\n> 1 files changed, 9 insertions(+), 7 deletions(-)\n>\n> diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt\n> index 70235e8..fc5f4e3 100644\n> --- a/Documentation/git-tag.txt\n> +++ b/Documentation/git-tag.txt\n> @@ -20,13 +20,15 @@ Adds a 'tag' reference in `.git/refs/tags/`\n> Unless `-f` is given, the tag must not yet exist in\n> `.git/refs/tags/` directory.\n>\n> -If one of `-a`, `-s`, or `-u ` is passed, the command\n> -creates a 'tag' object, and requires the tag message. Unless\n> -`-m ` is given, an editor is started for the user to type\n> -in the tag message.\n> -\n> -Otherwise just the SHA1 object name of the commit object is\n> -written (i.e. a lightweight tag).\n> +If one of `-a`, `-m `, `-F `, `-s`, or `-u ` is\n> +passed, the command creates a 'tag' object. Unless `-m ` or `-F\n> +` is given, an editor is started for the user to type in the tag\n> +message.\n> +\n> +Otherwise just the SHA1 object name of the commit object is written\n> +(i.e. a lightweight tag). Note that such tags are not automatically\n> +copied by \"git-clone\" and \"git-fetch\", so you want to use them for\n> +local tags only.\n>\n> A GnuPG signed tag object will be created when `-s` or `-u\n> ` is used. When `-u ` is not used, the\n>\n\n-- \nJulian\n\n ---\n\"But as a result of evil, there's some amazing things that are taking place in\nAmerica.\"\n\nGeorge W. Bush\nDaytona Beach, Florida.\n"},{"id":"38934","messageId":"87y7l11s5m.fsf@mid.deneb.enyo.de","threadId":"7583","inReplyTo":"Pine.LNX.4.64.0704091554330.32490@beast.quantumfyre.co.uk","subject":"Re: [PATCH] git-tag: Document that -m/-F create tag objects, too","fromName":"Florian Weimer","fromEmail":"fw@deneb.enyo.de","sentAt":"2007-04-09T15:31:01Z","receivedAt":"2007-04-09T15:31:01Z","isPatch":true,"sender":{"key":"fw@deneb.enyo.de","avatar":null},"body":"* Julian Phillips:\n\n> On Mon, 9 Apr 2007, Florian Weimer wrote:\n>\n>> And warn about the fact that lightweight tags are not normally\n>> transferred by clone/fetch.\n>\n> Um ... yes, they are (in v1.5.1 at least).\n\nHmm. This has to be a fairly recent change, see:\n\n\n"},{"id":"38933","messageId":"Pine.LNX.4.64.0704091641290.1420@beast.quantumfyre.co.uk","threadId":"7583","inReplyTo":"87y7l11s5m.fsf@mid.deneb.enyo.de","subject":"Re: [PATCH] git-tag: Document that -m/-F create tag objects, too","fromName":"Julian Phillips","fromEmail":"julian@quantumfyre.co.uk","sentAt":"2007-04-09T16:15:11Z","receivedAt":"2007-04-09T16:15:11Z","isPatch":true,"sender":{"key":"julian@quantumfyre.co.uk","avatar":"https://avatars.githubusercontent.com/u/948888?v=4"},"body":"On Mon, 9 Apr 2007, Florian Weimer wrote:\n\n> * Julian Phillips:\n>\n>> On Mon, 9 Apr 2007, Florian Weimer wrote:\n>>\n>>> And warn about the fact that lightweight tags are not normally\n>>> transferred by clone/fetch.\n>>\n>> Um ... yes, they are (in v1.5.1 at least).\n>\n> Hmm. This has to be a fairly recent change, see:\n>\n> \n>\n\nIt's not that recent a change. I have been cloning and fetching my \ntag-references for some time (being too lazy to use full tags for my \none-man projects). Certainly since v1.4.4 days ...\n\nFetch doesn't care whether a tag is a full tag or merely a reference, it \nwill automatically fetch them both in the same way (not sure about clone). \nIt checks that the reference points at an object, but not that the object \nis a tag rather than a commit. This behaviour hasn't changed since the \nauto tag-following code was added (AFAIK). Any difference between the \ntreatment of tags and tag-references is a subtle consequence of the former \nadding an object I expect.\n\nIn the case of the v2.6.21-rc6 tag-reference anyone who did a clone or \nfetch and may have got the tag-reference provided that they didn't already \nhave the commit it referenced? I'm not 100% sure of the behaviour here, I \nhaven't quite got to tag following in my C rewrite (I should be doing it \nlater today).\n\n-- \nJulian\n\n ---\nNever call a man a fool. Borrow from him.\n"}]}