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

Question

[Stnslvtvrn]

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

Суть вопроса в разнице предлагаемых гитом команд для отмены определенных действий.
Во всех пособиях это:

(use "git checkout -- <file>..." to discard changes in working directory)
 (use "git reset HEAD <file>..." to unstage)

Но по факту, при работе с git-bash мы получаем следующую картину

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   hello.html

и

$ git st
On branch master
Changes to be committed:
  (use "git restore --staged <file>..." 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, что бы новичкам (и не только) было проще.