Re: log-view documentation

["Aaron S. Hawley" <Aaron.Hawley@uvm.edu>]

[-- Attachment #1: Type: TEXT/PLAIN, Size: 1218 bytes --]

On Wed, 14 Dec 2005, Juri Linkov wrote:

> You could mention also how it works if there is the active mark in
> the log-view buffer.

> Also in the same thread Richard pointed out that actually `n' moves
> to the the previous revision, and `p' moves to the next revision,
> and not vice versa.

Hah, I never thought of it like that.  Good catch.

Thanks for bring both of these to my attention.

I've attached an updated patch.

Here's how it changed from the previous patch:

@item p
Move to the @emph{next} revision of the file.  Revision entries in the
log buffer are listed in descending order, therefore revision motion
is the inverse of point motion.  A numeric prefix argument is a repeat
count, so @kbd{C-u 10 p} would move 10 revisions.

@item n
Move to the @emph{previous} revision of the file.  A numeric prefix argument
is a repeat count.

[...]

@item d
Display the diff (@pxref{Comparing Files}) between the revision
indicated at the current line and the revision before it.  This is
useful to see what actually changed when the revision indicated on the
current line was committed.  When the mark is active (@pxref{Mark}),
display the diff between the revisions found at the start and end of
the region.

[-- Attachment #2: Type: TEXT/PLAIN, Size: 2724 bytes --]

Index: files.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/man/files.texi,v
retrieving revision 1.123
diff -u -r1.123 files.texi
*** files.texi	12 Dec 2005 00:55:25 -0000	1.123
--- files.texi	14 Dec 2005 17:45:24 -0000
***************
*** 1788,1794 ****
    To view the detailed version control status and history of a file,
  type @kbd{C-x v l} (@code{vc-print-log}).  It displays the history of
  changes to the current file, including the text of the log entries.  The
! output appears in a separate window.
  
  @node VC Undo
  @subsubsection Undoing Version Control Actions
--- 1788,1836 ----
    To view the detailed version control status and history of a file,
  type @kbd{C-x v l} (@code{vc-print-log}).  It displays the history of
  changes to the current file, including the text of the log entries.  The
! output appears in a separate window.  The point is centered at the
! revision of the file that is currently being visited.
! 
! From the change log buffer, the following keys are used to move
! between the logs of files and revisions, to view past revisions, and
! to view diffs:
! 
! @table @kbd
! 
! @item p
! Move to the @emph{next} revision of the file.  Revision entries in the
! log buffer are listed in descending order, therefore revision motion
! is the inverse of point motion.  A numeric prefix argument is a repeat
! count, so @kbd{C-u 10 p} would move 10 revisions.
! 
! @item n
! Move to the @emph{previous} revision of the file.  A numeric prefix argument
! is a repeat count.
! 
! @item f
! Visit the revision indicated at the current line, like typing @kbd{C-x
! v ~} and specifying the revision (@pxref{Old Versions}).
! 
! @item d
! Display the diff (@pxref{Comparing Files}) between the revision
! indicated at the current line and the revision before it.  This is
! useful to see what actually changed when the revision indicated on the
! current line was committed.  When the mark is active (@pxref{Mark}),
! display the diff between the revisions found at the start and end of
! the region.
! 
! @item P
! Move to the log of the previous file when the logs of multiple files
! are in the log buffer (@pxref{VC Dired Mode}).  Otherwise, the point
! just moves to the beginning of the log.  A numeric prefix argument is
! a repeat count, so @kbd{C-u 10 P} would move backward 10 files.
! 
! @item N
! Move to the log of the next file when the logs of multiple files are
! in the log buffer (@pxref{VC Dired Mode}).  It also takes a numeric
! prefix argument as a repeat count.
! 
! @end table
  
  @node VC Undo
  @subsubsection Undoing Version Control Actions

[-- Attachment #3: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel