From: Randall S. Becker Date: Mon, 11 Mar 2019 14:11:54 GMT Subject: RE: [PATCH v1 11/11] doc: promote "git restore" Message-ID: <000b01d4d814$64907000$2db15000$@nexbridge.com> In-Reply-To: > -----Original Message----- > From: git-owner@vger.kernel.org On Behalf > Of Elijah Newren > Sent: March 9, 2019 14:38 > To: Nguyễn Thái Ngọc Duy > Cc: Git Mailing List ; Junio C Hamano > > Subject: Re: [PATCH v1 11/11] doc: promote "git restore" > > On Fri, Mar 8, 2019 at 2:17 AM Nguyễn Thái Ngọc Duy > wrote: > > > > The new command "git restore" (together with "git switch") are added > > to avoid the confusion of one-command-do-all "git checkout" for new > > users. They are also helpful to avoid ambiguation context. > > s/ambiguation/ambiguous/ or s/ambiguation context/ambiguity/? > > > For these reasons, promote it everywhere possible. This includes > > documentation, suggestions/advice from other commands. > > > > One nice thing about git-restore is the ability to restore > > "everything", so it can be used in "git status" advice instead of both > > "git checkout" and "git reset". The three commands suggested by "git > > status" are add, rm and restore. > > > > "git checkout" is also removed from "git help" (i.e. it's no longer > > considered a commonly used command) Just curious: At what point did git checkout become not commonly used? Git switch and git restore are not yet in git as of 2.21.0, which is rather current. Maybe I missed a thread.