Subject: Re: [PATCH v4 1/5] doc: git-rebase: start with an example

From: Phillip Wood <[email-masked]>
Date: Mon, 11 Aug 2025 14:07:43 +0100

On 11/08/2025 10:13, Karthik Nayak wrote:
> "Julia Evans via GitGitGadget" <[email-masked]> writes:
>> +
>> +You want to transplant the commits you made on `topic` since it diverged from
>> +`master` (i.e. A, B, and C), on top of the current `master`.  You can do this
>> +by running `git rebase master` while the `topic` branch is checked out.  If you
>> +want to rebase `topic` while on another branch, `git rebase master topic` is a
>> +shortcut for `git checkout topic && git rebase master`.
>> +
> 
> Nit: now that `git-switch(1)` is no longer experimental, we should start
> recommending it over `git-checkout(1)` as necessary. So perhaps, we
> could s/checkout/switch here?

Junio has already expressed a preference for "checkout" here c.f. 
<[email-masked]>. I think that is technically correct as 
"topic" can be a commitish and "git switch <object-id>" fails without 
"--detach". Also rebase does not do any of the extra checks that "git 
switch" does before switching branches (I'm not saying that is 
necessarily a good thing).

Thanks

Phillip