Document 'vc-region-history'

* doc/emacs/maintaining.texi (VC Change Log): Document
'vc-region-history'.

diff --git a/doc/emacs/maintaining.texi b/doc/emacs/maintaining.texi
index cb43f767aa31d849b6939bb43311afcb5fa2c537..2d11b201d32d001b43659fc7c1c4e3e7eb112bbe 100644 (file)
--- 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.
 
+@findex vc-region-history
+A useful variant of examining changes is provided by the command
+@kbd{vc-region-history}, 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
+@file{*vc-change-log*} 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 a53c4540d03ce97c6476bb6219a183d7687c982e..8a926c2a731e9c058596e83eb76626afb8e15d3d 100644 (file)
--- 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.
 
 +++