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

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

On Thu, Jul 22 2021, Philip Oakley wrote:

quoted

On 21/07/2021 17:57, Junio C Hamano wrote:

quoted

Philip Oakley [off-list ref] writes:

quoted

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.

quoted

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