]> git.ipfire.org Git - thirdparty/git.git/commit
doc: git-checkout: split up restoring files section
authorJulia Evans <julia@jvns.ca>
Wed, 10 Sep 2025 19:14:28 +0000 (19:14 +0000)
committerJunio C Hamano <gitster@pobox.com>
Wed, 10 Sep 2025 21:32:05 +0000 (14:32 -0700)
commitbfe7b17c253eaeefc024ed7fef80787dd80d45fd
treeaaa9aa5bffc52964505ad6549a4b822a2c9fd126
parent0dd71f607c2b16e56b72a1e86262eb2b9e52e343
doc: git-checkout: split up restoring files section

From user feedback: one user mentioned that "When the <tree-ish> (most
often a commit) is not given" is confusing since it starts with a
negative.

Restructuring so that `git checkout main file.txt` and
`git checkout file.txt` are separate items will help us simplify the
sentence structure a lot.

As a bonus, it appears that `-f` actually only applies to one of those
forms, so we can include fewer options, and now the structure of the
DESCRIPTION matches the SYNOPSIS.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-checkout.adoc