On 22/07/2021 12:46, Ævar Arnfjörð Bjarmason wrote: > 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