On Mon, Jan 9, 2023 at 5:53 AM Yutaro Ohno via GitGitGadget <gitgitgadget@xxxxxxxxx> wrote: > 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@xxxxxxxxx> > --- > 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@xxxxxxxxxxxxxx/ [2]: https://lore.kernel.org/git/xmqqk01wusmz.fsf@gitster.g/ [3]: https://lore.kernel.org/git/CAPig+cTO1jBjcwjX4UpxG813OwrDAaYVvViC_XGWorwbXvOfvw@xxxxxxxxxxxxxx/
