Re: [PATCH] Update packfile transfer protocol documentation

From: Shawn O. Pearce <spearce@spearce.org>
Date: Nov 2, 2009, 15:43 UTC
Message-ID: <20091102154350.GS10505@spearce.org>
In-Reply-To: <d411cc4a0911011518q15a8267bn642e6937be8c9ab1@mail.gmail.com>

Scott Chacon <schacon@gmail.com> wrote:

> I've incorporated the comments from Shawn (except for the 'annotated
> tag' comment
> in the 'include-tag' section of the capabilities doc, which I didn't
> understand).

...

Show 8 quoted lines

> +include-tag
> +-----------
> +
> +The 'include-tag' capability is about sending tags if we are sending
> +objects they point to.  If we pack an object to the client, and a tag
> +points exactly at that object, we pack the tag too.  In general this
> +allows a client to get all new tags when it fetches a branch, in a
> +single network connection.

There are two types of tags, annotated and lightweight, right?

To avoid confusion here we should make it clear we only send annotated tag objects when this feature is enabled. The protocol doesn't have provisions to send SHA-1 to ref mapping inside of a pack stream, so lightweight tags cannot be sent.

-- 
Shawn.