]> git.ipfire.org Git - thirdparty/git.git/commit
doc: git-reset: clarify `git reset <pathspec>`
authorJulia Evans <julia@jvns.ca>
Mon, 5 Jan 2026 21:48:18 +0000 (16:48 -0500)
committerJunio C Hamano <gitster@pobox.com>
Mon, 5 Jan 2026 23:10:14 +0000 (08:10 +0900)
commit555c8464e5949fcd35ec9878f83874a998beb787
treeff3abee818b3ba9d375ef1c710945efa4f926e11
parent7fb080a790b6410f8e36dbc10c5d9be0ff47ce98
doc: git-reset: clarify `git reset <pathspec>`

From user feedback:

- Continued confusion about the terms "tree-ish" and "pathspec"
- The word "hunks" is confusing folks, use "changes" instead.
- On the part about `git restore`, there were a few comments to the
  effect of "wait, this doesn't actually update any files? What? Why?"
  Be more direct that `git reset` does not update files: there's no
  obvious reason to suggest that folks use `git reset` followed by `git
  restore`, instead suggest just using `git restore`.

Continue avoiding the use of the word "reset" to
describe what "git reset" does.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Signed-off-by: D. Ben Knoble <ben.knoble+github@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-reset.adoc