Re: log-view documentation

[Aaron S. Hawley]

On Wed, 23 Nov 2005, Richard M. Stallman wrote:

> Our style is to use @table @kbd for this.
> Please look at other such lists in the manual
> to see the proper style, especially for index entries
> and for giving the names of the commands.

That makes sense.  I was confused by the commands marked up as a list in
the "Old Versions" node -- no longer!

I've modified the patch to use the Texinfo table style.  I adopted (read:
copied)  and incorporated respectively the wording changes you've proposed
for documenting `vc-annotate'.  I also added some more cross references.
The patch is attached, but here's the table.

 @table @kbd

 @item p
 Move to the previous revision of the file.  A numeric prefix argument
 is a repeat count, so @kbd{C-u 10 p} would move backward 10 revisions.

 @item n
 Move to the next 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.

 @item P
 Move to the log of the previous file when there are multiple files in
 the log buffer (@pxref{VC Dired Mode}).  Otherwise, it moves to the
 beginning of the log.  It also takes a numeric prefix argument as 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 there are logs for multiple
 files in the log buffer (@pxref{VC Dired Mode}).  It also takes a
 numeric prefix argument as a repeat count.

 @end table

files.texi-log_buffer_commands.diff
Description: log-view patch