git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v3 3/5] git-reset.txt: better docs for '--patch'

From
Valentin Haenel <valentin.haenel@gmx.de>
Date
May 5, 2011, 18:48 UTC
Message-ID
<1304621328-17184-3-git-send-email-valentin.haenel@gmx.de>
In-Reply-To
<1304621271-17107-1-git-send-email-valentin.haenel@gmx.de>
* Include '-p' in the synopsis.
* Include a better wording for what 'git reset -p' does.
  (interactively unstage hunks)
* Include a link to the git-add manpage for a description of the patch-mode.
Signed-off-by: Valentin Haenel <valentin.haenel@gmx.de>
Helped-by: Jeff King <peff@peff.net>
Mentored-by: Junio C Hamano <gitster@pobox.com>
---
 Documentation/git-reset.txt |    7 ++++---
 1 files changed, 4 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-reset.txt b/Documentation/git-reset.txt
index 8481f9d..b6ed0c7 100644
--- a/Documentation/git-reset.txt
+++ b/Documentation/git-reset.txt
@@ -9,7 +9,7 @@ SYNOPSIS
 --------
 [verse]
 'git reset' [-q] [<commit>] [--] <paths>...
-'git reset' --patch [<commit>] [--] [<paths>...]
+'git reset' --patch|-p [<commit>] [--] [<paths>...]
 'git reset' [--soft | --mixed | --hard | --merge | --keep] [-q] [<commit>]
 
 DESCRIPTION
@@ -39,8 +39,9 @@ working tree in one go.
 	and <commit> (defaults to HEAD).  The chosen hunks are applied
 	in reverse to the index.
 +
-This means that `git reset -p` is the opposite of `git add -p` (see
-linkgit:git-add[1]).
+This means that `git reset -p` is the opposite of `git add -p`, i.e.
+you can use it to selectively unstage hunks. See the ``Interactive Mode''
+section of linkgit:git-add[1] to learn how to operate the `\--patch` mode.
 
 'git reset' [--<mode>] [<commit>]::
 	This form resets the current branch head to <commit> and
-- 
1.7.1
Previous: Valentin HaenelNext: Junio C Hamano
Message 13 of 23 in “config.txt: interactive.singlekey is used by...”
  1. config.txt: interactive.singlekey is used by...Valentin Haenel, Apr 30, 2011
  2. Jeff KingMay 1, 2011
  3. 0/5 better document 'interactive.singlekey'Valentin Haenel, May 2, 2011
  4. 1/5 config.txt: 'interactive.singlekey; is used by...Valentin Haenel, May 2, 2011
  5. 2/5 git-add.txt: document 'interactive.singlekey'Valentin Haenel, May 2, 2011
  6. Junio C HamanoMay 2, 2011
  7. Valentin HaenelMay 3, 2011
  8. Junio C HamanoMay 3, 2011
  9. git-add.txt: document 'add.ignoreErrors'Valentin Haenel, May 4, 2011
  10. 0/5 better document 'interactive.singlekey' and '--patch'Valentin Haenel, May 5, 2011
  11. 1/5 config.txt: 'interactive.singlekey; is used by...Valentin Haenel, May 5, 2011
  12. 2/5 git-add.txt: document 'interactive.singlekey'Valentin Haenel, May 5, 2011
  13. 3/5 git-reset.txt: better docs for '--patch'Valentin Haenel, May 5, 2011
  14. Junio C HamanoMay 5, 2011
  15. Valentin HaenelMay 5, 2011
  16. 3/5 git-reset.txt: better docs for '--patch'Valentin Haenel, May 5, 2011
  17. 4/5 git-stash.txt: better docs for '--patch'Valentin Haenel, May 5, 2011
  18. 5/5 git-checkout.txt: better docs for '--patch'Valentin Haenel, May 5, 2011
  19. Junio C HamanoMay 5, 2011
  20. Junio C HamanoMay 5, 2011
  21. 3/5 git-reset.txt: document 'interactive.singlekey'Valentin Haenel, May 2, 2011
  22. 4/5 git-stash.txt: document 'interactive.singlekey'Valentin Haenel, May 2, 2011
  23. 5/5 git-checkout.txt: document 'interactive.singlekey'Valentin Haenel, May 2, 2011

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.