* [PATCH] git-tag: Document that -m/-F create tag objects, too
@ 2007-04-09 12:06 Florian Weimer
2007-04-09 14:58 ` Julian Phillips
0 siblings, 1 reply; 4+ messages in thread
From: Florian Weimer @ 2007-04-09 12:06 UTC (permalink / raw
To: git
And warn about the fact that lightweight tags are not normally
transferred by clone/fetch.
Signed-off-by: Florian Weimer <fw@deneb.enyo.de>
---
Documentation/git-tag.txt | 16 +++++++++-------
1 files changed, 9 insertions(+), 7 deletions(-)
diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
index 70235e8..fc5f4e3 100644
--- a/Documentation/git-tag.txt
+++ b/Documentation/git-tag.txt
@@ -20,13 +20,15 @@ Adds a 'tag' reference in `.git/refs/tags/`
Unless `-f` is given, the tag must not yet exist in
`.git/refs/tags/` directory.
-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.
-
-Otherwise just the SHA1 object name of the commit object is
-written (i.e. a lightweight tag).
+If one of `-a`, `-m <msg>`, `-F <file>`, `-s`, or `-u <key-id>` is
+passed, the command creates a 'tag' object. Unless `-m <msg>` or `-F
+<file>` 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). Note that such tags are not automatically
+copied by "git-clone" and "git-fetch", so you want to use them for
+local tags only.
A GnuPG signed tag object will be created when `-s` or `-u
<key-id>` is used. When `-u <key-id>` is not used, the
--
1.5.1
^ permalink raw reply related [flat|nested] 4+ messages in thread
* Re: [PATCH] git-tag: Document that -m/-F create tag objects, too
2007-04-09 12:06 [PATCH] git-tag: Document that -m/-F create tag objects, too Florian Weimer
@ 2007-04-09 14:58 ` Julian Phillips
2007-04-09 15:31 ` Florian Weimer
0 siblings, 1 reply; 4+ messages in thread
From: Julian Phillips @ 2007-04-09 14:58 UTC (permalink / raw
To: Florian Weimer; +Cc: git
On Mon, 9 Apr 2007, Florian Weimer wrote:
> And warn about the fact that lightweight tags are not normally
> transferred by clone/fetch.
Um ... yes, they are (in v1.5.1 at least).
>
> Signed-off-by: Florian Weimer <fw@deneb.enyo.de>
> ---
> Documentation/git-tag.txt | 16 +++++++++-------
> 1 files changed, 9 insertions(+), 7 deletions(-)
>
> diff --git a/Documentation/git-tag.txt b/Documentation/git-tag.txt
> index 70235e8..fc5f4e3 100644
> --- a/Documentation/git-tag.txt
> +++ b/Documentation/git-tag.txt
> @@ -20,13 +20,15 @@ Adds a 'tag' reference in `.git/refs/tags/`
> Unless `-f` is given, the tag must not yet exist in
> `.git/refs/tags/` directory.
>
> -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.
> -
> -Otherwise just the SHA1 object name of the commit object is
> -written (i.e. a lightweight tag).
> +If one of `-a`, `-m <msg>`, `-F <file>`, `-s`, or `-u <key-id>` is
> +passed, the command creates a 'tag' object. Unless `-m <msg>` or `-F
> +<file>` 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). Note that such tags are not automatically
> +copied by "git-clone" and "git-fetch", so you want to use them for
> +local tags only.
>
> A GnuPG signed tag object will be created when `-s` or `-u
> <key-id>` is used. When `-u <key-id>` is not used, the
>
--
Julian
---
"But as a result of evil, there's some amazing things that are taking place in
America."
George W. Bush
Daytona Beach, Florida.
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] git-tag: Document that -m/-F create tag objects, too
2007-04-09 14:58 ` Julian Phillips
@ 2007-04-09 15:31 ` Florian Weimer
2007-04-09 16:15 ` Julian Phillips
0 siblings, 1 reply; 4+ messages in thread
From: Florian Weimer @ 2007-04-09 15:31 UTC (permalink / raw
To: Julian Phillips; +Cc: git
* Julian Phillips:
> On Mon, 9 Apr 2007, Florian Weimer wrote:
>
>> And warn about the fact that lightweight tags are not normally
>> transferred by clone/fetch.
>
> Um ... yes, they are (in v1.5.1 at least).
Hmm. This has to be a fairly recent change, see:
<http://article.gmane.org/gmane.linux.kernel/513438>
^ permalink raw reply [flat|nested] 4+ messages in thread
* Re: [PATCH] git-tag: Document that -m/-F create tag objects, too
2007-04-09 15:31 ` Florian Weimer
@ 2007-04-09 16:15 ` Julian Phillips
0 siblings, 0 replies; 4+ messages in thread
From: Julian Phillips @ 2007-04-09 16:15 UTC (permalink / raw
To: Florian Weimer; +Cc: git
On Mon, 9 Apr 2007, Florian Weimer wrote:
> * Julian Phillips:
>
>> On Mon, 9 Apr 2007, Florian Weimer wrote:
>>
>>> And warn about the fact that lightweight tags are not normally
>>> transferred by clone/fetch.
>>
>> Um ... yes, they are (in v1.5.1 at least).
>
> Hmm. This has to be a fairly recent change, see:
>
> <http://article.gmane.org/gmane.linux.kernel/513438>
>
It's not that recent a change. I have been cloning and fetching my
tag-references for some time (being too lazy to use full tags for my
one-man projects). Certainly since v1.4.4 days ...
Fetch doesn't care whether a tag is a full tag or merely a reference, it
will automatically fetch them both in the same way (not sure about clone).
It checks that the reference points at an object, but not that the object
is a tag rather than a commit. This behaviour hasn't changed since the
auto tag-following code was added (AFAIK). Any difference between the
treatment of tags and tag-references is a subtle consequence of the former
adding an object I expect.
In the case of the v2.6.21-rc6 tag-reference anyone who did a clone or
fetch and may have got the tag-reference provided that they didn't already
have the commit it referenced? I'm not 100% sure of the behaviour here, I
haven't quite got to tag following in my C rewrite (I should be doing it
later today).
--
Julian
---
Never call a man a fool. Borrow from him.
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2007-04-09 16:15 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2007-04-09 12:06 [PATCH] git-tag: Document that -m/-F create tag objects, too Florian Weimer
2007-04-09 14:58 ` Julian Phillips
2007-04-09 15:31 ` Florian Weimer
2007-04-09 16:15 ` Julian Phillips
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).