Re: [PATCH v5 4/4] BreakingChanges: document that we do not plan to deprecate git-checkout
On Mon, Jun 03, 2024 at 09:52:33AM -0700, Junio C Hamano wrote:
Show 18 quoted lines
> Patrick Steinhardt <ps@pks.im> writes:
>
> > +
> > +* git-restore(1) and git-switch(1) have been introduced as a replacement for
> > + git-checkout(1). As git-checkout(1) is quite established, and as the benefit
> > + of switching to git-restore(1) and git-switch(1) is contended, all three
> > + commands will stay.
>
> "As a replacement" is probably a bit different from the truth [*],
> but I suspect that the reason why they were introduced no longer has
> much relevance. How about
>
> The features git-checkout(1) offers are covered by the pair of
> commands git-restore(1) and git-switch(1). Because the use of
> git-checkout(1) is still widespread, and it is not expected that
> this will change anytime soon.
>
> or something (borrowing from your proposed log message)?
Fair enough, let's add it like this. Thanks!
Patrick