Re: [PATCH v6 3/3] bundle doc: elaborate on rev<->ref restriction

From: Philip Oakley <philipoakley@iee.email>
Date: Jul 22, 2021, 23:14 UTC
Message-ID: <697ca0f3-a897-a20b-48e4-bf439697afb5@iee.email>
In-Reply-To: <87v952tvrz.fsf@evledraar.gmail.com>

On 22/07/2021 12:46, Ævar Arnfjörð Bjarmason wrote:

Show 21 quoted lines

> On Thu, Jul 22 2021, Philip Oakley wrote:
>
>> On 21/07/2021 17:57, Junio C Hamano wrote:
>>> Philip Oakley <philipoakley@iee.email> writes:
>>>
>>>> Should the `list-heads` option be mentioned for investigating existing
>>>> bundles?
>>> I think 'list-heads' has been listed in the options section.  
>> True, it's why I was suggesting pointing at that route for the extra
>> details that are beyond just a set of refs.
>>
>>> I
>>> however may encourage people to use "git ls-remote one.bndl" over
>>> "git bundle list-heads one.bndl"---they do the same thing, no?
>> It is good to provide both directions to the user. The formats may be
>> different but the content is essentially the same, and redirecting users
>> to the more core command is useful.
>>
> I'll work those suggestions into a future update of the docs I have
> queued, but for now I think talking about list-heads v.s. ls-remote
> doesn't have much directly to do with this particular series, correct?

True.

However I'm still not really clear about the distinction between the 'basis' and the `header references` (that is, the text doesn't make it clear).

for the future updates, it would also be good if the `--all` and `--branches --tags` text was also shown in the examples - I continue to get StackOverflow points for my Q&A on that ;-)

Philip