]> git.ipfire.org Git - thirdparty/git.git/commit - Documentation/git-format-patch.txt
doc: promote "git restore"
authorNguyễn Thái Ngọc Duy <pclouds@gmail.com>
Thu, 25 Apr 2019 09:45:58 +0000 (16:45 +0700)
committerJunio C Hamano <gitster@pobox.com>
Tue, 7 May 2019 04:04:48 +0000 (13:04 +0900)
commit80f537f79c16efeb7b92b3409ede434a230b5679
tree28b73ceb285fde7cec4ef84c4b685534887397c3
parentfc991b43df83ee32a92b9d906e77276e5dbd639c
doc: promote "git restore"

The new command "git restore" (together with "git switch") are added
to avoid the confusion of one-command-do-all "git checkout" for new
users. They are also helpful to avoid ambiguous context.

For these reasons, promote it everywhere possible. This includes
documentation, suggestions/advice from other commands.

One nice thing about git-restore is the ability to restore
"everything", so it can be used in "git status" advice instead of both
"git checkout" and "git reset".  The three commands suggested by "git
status" are add, rm and restore.

"git checkout" is also removed from "git help" (i.e. it's no longer
considered a commonly used command)

Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
16 files changed:
Documentation/git-clean.txt
Documentation/git-commit.txt
Documentation/git-format-patch.txt
Documentation/git-reset.txt
Documentation/git-revert.txt
Documentation/gitcli.txt
Documentation/giteveryday.txt
Documentation/gittutorial-2.txt
Documentation/gittutorial.txt
Documentation/user-manual.txt
builtin/clone.c
builtin/commit.c
command-list.txt
t/t7508-status.sh
t/t7512-status-help.sh
wt-status.c