From: Philip Oakley <philipoakley@iee.email>
Date: Wed, 21 Jul 2021 09:27:40 GMT
Subject: Re: [PATCH v6 3/3] bundle doc: elaborate on rev<->ref restriction
Message-ID: <68ea4cc0-b9d3-a7fb-7c22-fa828f9dc52f@iee.email>
In-Reply-To: <xmqqo8awhh5z.fsf@gitster.g>

On 20/07/2021 21:19, Junio C Hamano wrote:
> Ævar Arnfjörð Bjarmason  <avarab@gmail.com> writes:
>
>> +Revisions must accompanied by reference names to be packaged in a
>> +bundle, since the header of the bundle is in a format similar to 'git
>> +show-ref'.
> This may be an improvement in the way how the description refers to
> "show-ref", but we do not have to say anything about "show-ref" ;-)
>
> The reason we should give readers why they must give refs while
> creating a bundle, I think, is because the only way to access the
> contents of the bundle is to fetch refs from it, and the refs given
> to the command when the bundle was created becomes the refs that can
> be fetched from the bundle.
>
> Thanks.
>
Should the `list-heads` option be mentioned for investigating existing
bundles?
--
Philip