[Emacs-diffs] emacs-25 ca13f61: Document 'vc-region-history'

[Eli Zaretskii]

branch: emacs-25
commit ca13f61dea7030452848d455db7d3aba9e2e7a85
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    Document 'vc-region-history'
    
    * doc/emacs/maintaining.texi (VC Change Log): Document
    'vc-region-history'.
---
 doc/emacs/maintaining.texi |   16 ++++++++++++++++
 etc/NEWS                   |    1 +
 2 files changed, 17 insertions(+), 0 deletions(-)

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index cb43f76..2d11b20 100644
--- a/doc/emacs/maintaining.texi
+++ b/doc/emacs/maintaining.texi
@@ -1020,6 +1020,22 @@ increase the number of revisions shown in an existing
 entries} or @samp{Show unlimited entries} buttons at the end of the
 buffer.  However, RCS, SCCS, and CVS do not support this feature.
 
address@hidden vc-region-history
+A useful variant of examining changes is provided by the command
address@hidden, which shows a @file{*VC-history*} buffer with
+the history of changes to the region of the current file between point
+and the mark (@pxref{Mark}).  The history of changes includes the
+commit log messages and also the changes themselves in the Diff
+format.
+
+Invoke this command after marking the region of the current file in
+whose changes you are interested.  In the @file{*VC-history*} buffer
+it pops up, you can use all of the commands available in the
address@hidden buffer described above, and also the commands
+defined by Diff mode (@pxref{Diff Mode}).
+
+This command is currently available only with Git.
+
 @node VC Undo
 @subsection Undoing Version Control Actions
 
diff --git a/etc/NEWS b/etc/NEWS
index a53c454..8a926c2 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -817,6 +817,7 @@ comments.
 Implemented for Bzr, Git, Hg.  As part of this change, the pre-existing
 (undocumented) command vc-hg-push now behaves slightly differently.
 
++++
 *** The new command vc-region-history shows the log+diff of the active region.
 
 +++