Re: [PATCH] protocol-capabilities.txt: document symref

From: Josh Steadmon <steadmon@google.com>
Date: Feb 12, 2019, 00:07 UTC
Message-ID: <20190212000749.GF72177@google.com>
In-Reply-To: <20190212000530.GC13301@sigill.intra.peff.net>

On 2019.02.11 19:05, Jeff King wrote:

Show 16 quoted lines

> On Mon, Feb 11, 2019 at 03:52:24PM -0800, Josh Steadmon wrote:
> 
> > In 7171d8c15f ("upload-pack: send symbolic ref information as
> > capability"), we added a symref capability to the pack protocol, but it
> > was never documented. Adapt the patch notes from that commit and add
> > them to the capabilities documentation.
> 
> Good catch, and your explanation (especially the SHOULD/MAY bits) looks
> good.
> 
> I think this is obsoleted by v2, which will send symref info along with
> each ref. I don't know if it's worth mentioning that here (the v2 docs
> discuss it, but I don't know if this capabilities document is clear
> about which ones apply only to v0).
> 
> -Peff

I believe this doc is only for v0/v1. I'll add a note.