On Tue, Jun 04, 2024 at 03:01:42PM -0700, Junio C Hamano wrote: > tl;dr for those who did read v1: v2 does not warn when deprecated > variants are used. > ---------------------- > > Back when Git started, we used the word "head" to mean the tip of > possibly multiple histories, and that is where the name of the > hierarchy .git/refs/heads/ came from. But these days we call these > entities "branches" in human terms, and "head" is still used to > refer to the tip of the history each of these branches represent. > > When asking "git ls-remote" or "git show-ref" to limit their output > to branches (as opposed to showing any ref), we use "--heads" for > historical reasons, but give the option a more human friendly name > "--branches", and demote "--heads" to the status of a deprecated > synonym. > > We do not plan to remove "--heads" or "-h" yet, but we may want to > do so at the Git 3.0 boundary, in which case we will need to start > advertising upcoming removal with an extra warning when they are > used. But let's not start annoying users for now. This version looks good to me, thanks! Patrick
Attachment:
signature.asc
Description: PGP signature
