Re: [PATCH] git-tag: Document that -m/-F create tag objects, too

From: Julian Phillips <julian@quantumfyre.co.uk>
Date: Apr 9, 2007, 14:58 UTC
Message-ID: <Pine.LNX.4.64.0704091554330.32490@beast.quantumfyre.co.uk>
In-Reply-To: <E1Hash0-0004rN-Mu@mid.deneb.enyo.de>

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).

Show 34 quoted lines

>
> 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.