git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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/

Previous: Yutaro Ohno via GitGitGadgetNext: Junio C Hamano
Message 13 of 14 in “doc: use "git switch -c" rather than "git checkout -b" consistently”
  1. doc: use "git switch -c" rather than "git checkout -b" consistentlyYutaro Ohno via GitGitGadget, Jan 8, 2023
  2. Junio C HamanoJan 9, 2023
  3. Eric SunshineJan 9, 2023
  4. Junio C HamanoJan 9, 2023
  5. Eric SunshineJan 9, 2023
  6. Yutaro OhnoJan 9, 2023
  7. rsbecker@nexbridge.comJan 9, 2023
  8. Eric SunshineJan 9, 2023
  9. rsbecker@nexbridge.comJan 9, 2023
  10. Eric SunshineJan 9, 2023
  11. Ævar Arnfjörð BjarmasonJan 9, 2023
  12. doc: add "git switch -c" as another option on detached HEADYutaro Ohno via GitGitGadget, Jan 9, 2023
  13. Eric SunshineJan 9, 2023
  14. Junio C HamanoJan 13, 2023

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.