; * etc/NEWS: Clarify wording of "C-x v v" entry.

1 files changed, 10 insertions, 5 deletions

diff --git a/etc/NEWS b/etc/NEWS
index a40954a8376..8d251448d35 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1583,11 +1583,16 @@ info node.  This command only works for the Emacs and Emacs Lisp manuals.
 This command marks files based on a regexp.  If given a prefix
 argument, unmark instead.
 
-*** 'C-x v v' on a diff buffer commits it as a patch.
-You can create a diff buffer by e.g. 'C-x v D' ('vc-root-diff'),
-then remove unnecessary hunks, and commit only part of your changes
-by typing 'C-x v v' in that diff buffer.  Currently this works only
-with Git.
+---
+*** 'C-x v v' in a diffs buffer allows to commit only some of the changes.
+This command is intended to allow you to commit only some of the
+changes you have in your working tree.  Begin by creating a buffer
+with the changes against the last commit, e.g. with 'C-x v D'
+('vc-root-diff').  Then edit the diffs to remove the hunks you don't
+want to commit.  Finally, type 'C-x v v' in that diff buffer to commit
+only part of your changes, those whose hunks were left in the buffer.
+
+Currently this feature works only with the Git as 'vc-backend'.
 
 ---
 *** 'C-x v v' on an unregistered file will now use the most specific backend.