Junio C Hamano <gitster@xxxxxxxxx> writes: > "D. Ben Knoble" <ben.knoble@xxxxxxxxx> writes: > >>> > Junio has already expressed a preference for "checkout" here c.f. >>> > <xmqqldnte6h3.fsf@gitster.g>. I think that is technically correct as >>> > "topic" can be a commitish and "git switch <object-id>" fails without >>> > "--detach". > > I wanted the new documentation text to use what was already used in > the parts of the document that are not touched; otherwise we end up > with text that uses checkout in some places and switch in others, > which would invite confusions among uninitiated readers, who > rightfully would wonder what criteria were used to decide which one > among these two different commands to use. And teaching that these > two commands are quasi-equivalent with possibly subtle differences > is not what the documentation of "git rebase" needs to do---it is a > distraction. > > I do not mind a new proposal to do a documentation sweep, aiming for > Git 3.0 timeframe, to examine all mentions of "git checkout" in the > documentation and replace them with "git switch" or "git restore" > when appropriate (there are of course ones that are not for obvious > reasons, like the ones in "git checkout" documentation itself, and > possibly in "git switch" and "git restore" documentation pages that > may say things like "'git switch X' is similar to 'git checkout Y'"). > I think this is the best way to tackle this. > But let's leave that outside this topic. > Agreed. > Thanks.
Attachment:
signature.asc
Description: PGP signature
