Откуда разница между документацией и фактическими командами GIT?

Question

[Stnslvtvrn]

Всем доброго времени суток. В процессе изучения GITа столкнулся с крайне интересным феноменом. Скажу сразу, что изучаю его основываясь на git-scm и githowto.

Суть вопроса в разнице предлагаемых гитом команд для отмены определенных действий.
Во всех пособиях это:
(use "git checkout -- ..." to discard changes in working directory)
(use "git reset HEAD ..." to unstage)

Но по факту, при работе с git-bash мы получаем следующую картину
Changes not staged for commit:
(use "git add ..." to update what will be committed)
(use "git restore ..." to discard changes in working directory)
modified: hello.html

и

$ git st
On branch master
Changes to be committed:
(use "git restore --staged ..." to unstage)
modified: hello.html

Вопрос, почему так? И все же какой способ правильнее использовать.
Для наглядности прилагаю скрин:


Второй скрин сделан с сайта: https://git-scm.com/book/en/v2/Git-Basics-Recordin...

Comments

[Евгений Самсонов]

Недавно сделали команду restore. Используйте любой

[Stnslvtvrn]

Евгений Самсонов, вроде как все таки разница есть, если не ошибаюсь reset затирает за собой абсолютно все изменения без возможности восстановления?

[jcmvbkbc]

reset затирает за собой абсолютно все изменения без возможности восстановления

Stnslvtvrn, зависит от ключей, например после git reset с ключами --soft или --mixed рабочая копия остаётся нетронутой.

[Евгений Самсонов]

Stnslvtvrn, там же написано, что в указанном виде они делают одно и то же. Это синонимы. В старых версиях просто не было команды restore

Answer 1

[Lynn «Кофеман»]

Команда git restore (и git switch) появились относительно недавно, в версии 2.23 в августе 2019 года.

Они созданы как более простые замены для основных способов использования git checkout, что бы новичкам (и не только) было проще.