Re: [PATCH v2] doc: add "git switch -c" as another option on detached HEAD
- From
Eric Sunshine <sunshine@sunshineco.com>
- Date
- Jan 9, 2023, 19:53 UTC
- Message-ID
- <CAPig+cTHMEeUw8PVg7nWU8+jdo=yN9nC+RRuaSiVg8D3Or-nNQ@mail.gmail.com>
- In-Reply-To
- <pull.1422.v2.git.git.1673261237449.gitgitgadget@gmail.com>
On Mon, Jan 9, 2023 at 5:53 AM Yutaro Ohno via GitGitGadget <gitgitgadget@gmail.com> wrote:
Show 22 quoted lines
> In the "DETACHED HEAD" section in the git-checkout doc, it suggests > using "git checkout -b <branch-name>" to create a new branch on the > detached head. > > On the other hand, when you checkout a commit that is not at the tip of > any named branch (e.g., when you checkout a tag), git suggests using > "git switch -c <branch-name>". > > Add "git switch -c" as another option and mitigate this inconsistency. > > Signed-off-by: Yutaro Ohno <yutaro.ono.418@gmail.com> > --- > diff --git a/Documentation/git-checkout.txt b/Documentation/git-checkout.txt > @@ -477,9 +477,9 @@ before that happens. If we have not yet moved away from commit `f`, > ------------ > -$ git checkout -b foo <1> > -$ git branch foo <2> > -$ git tag foo <3> > +$ git checkout -b foo # or "git switch -c foo" <1> > +$ git branch foo <2> > +$ git tag foo <3> > ------------
Thanks. This version looks good to me and addresses reviewer comments[1,2,3].
[1]: https://lore.kernel.org/git/CAPig+cQe_VMW2KV+ZyZwosFw07Q+hePryDVushRJ-jFfD4yzpw@mail.gmail.com/ [2]: https://lore.kernel.org/git/xmqqk01wusmz.fsf@gitster.g/ [3]: https://lore.kernel.org/git/CAPig+cTO1jBjcwjX4UpxG813OwrDAaYVvViC_XGWorwbXvOfvw@mail.gmail.com/