On March 8, 2019 1:57:41 AM PST, "Nguyễn Thái Ngọc Duy" <pclo...@gmail.com>
wrote:
>"git checkout" doing too many things is a source of confusion for many
>users (and it even bites old timers sometimes). To remedy that, the
>command will be split into two new ones: switch and
>something-to-checkout-paths. The good old "git checkout" command is
>still here and will be until all (or most of users) are sick of it.
>
>See the new man page for the final design of switch. The actual
>implementation though is still pretty much the same as "git checkout"
>and not completely aligned with the man page. Following patches will
>adjust their behavior to match the man page.
>---
> .gitignore | 1 +
> Documentation/config/advice.txt | 13 +-
> Documentation/config/branch.txt | 4 +-
> Documentation/config/checkout.txt | 9 +-
> Documentation/config/diff.txt | 3 +-
> Documentation/git-checkout.txt | 4 +
> Documentation/git-switch.txt | 259 ++++++
>+<new-branch>::
>+ Name for the new branch.
>+
>+<start-point>::
>+ The name of a commit at which to switch to before creating a
>+ new branch or detach from.
The wording here (and a few other places) feels awkward to me. I don't really
have a better wording but maybe:
---
The name of the commit to switch to when creating a new branch or detaching HEAD
---
The original has weird tense when using detach.
There were a few other places like this where the wording was "or detach from"
but where the verb tense was confusing
Thanks,
Jake
--
Sent from my Android device with K-9 Mail. Please excuse my brevity.
