Files
git/Documentation
Julia Evans 042d6f3402 doc: git-checkout: clarify -b and -B
From user feedback: several users reported having trouble understanding
the difference between `-b` and `-B` ("I think it's because my brain
expects it to contrast with `-b`, but instead it starts off explaining
how they're the same").

Also, in `-B`, 2 users can't tell what the branch is reset *to*.

Simplify the sentence structure in the explanations of `-b` and `-B` and
add a little extra information (what `<start-point>` is, what the branch
is reset to).

Splitting up `-b` and `-B` into separate items helps simplify the
sentence structure since there's less "In this case...".

Replace the long "the branch is not reset/created unless "git checkout"
is successful..." with just "will fail", since we should generally
assume that Git will fail operations in a clean way and not leave
operations half-finished, and that cases where it does not fail cleanly
are the exceptions that the documentation should flag.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2025-09-10 14:32:04 -07:00
..
2025-08-25 14:22:04 -07:00
2025-03-01 10:26:15 -08:00
2025-02-14 17:53:47 -08:00
2025-06-17 10:44:38 -07:00
2025-08-17 09:13:41 -07:00
2025-08-04 08:10:33 -07:00
2025-02-14 17:53:47 -08:00
2025-08-25 14:22:04 -07:00