From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Aaron S. Hawley" Newsgroups: gmane.emacs.devel Subject: log-view documentation Date: Tue, 22 Nov 2005 12:45:53 -0500 (EST) Organization: University of Vermont Message-ID: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-Trace: sea.gmane.org 1132683874 27058 80.91.229.2 (22 Nov 2005 18:24:34 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 22 Nov 2005 18:24:34 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Nov 22 19:24:33 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EeckX-0007MH-BH for ged-emacs-devel@m.gmane.org; Tue, 22 Nov 2005 19:20:14 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EeckW-0007G3-I8 for ged-emacs-devel@m.gmane.org; Tue, 22 Nov 2005 13:20:12 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EecDN-0000JU-8N for emacs-devel@gnu.org; Tue, 22 Nov 2005 12:45:57 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EecDM-0000Hm-1W for emacs-devel@gnu.org; Tue, 22 Nov 2005 12:45:56 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EecDL-0000Hc-Tb for emacs-devel@gnu.org; Tue, 22 Nov 2005 12:45:55 -0500 Original-Received: from [132.198.101.202] (helo=pony.uvm.edu) by monty-python.gnu.org with esmtp (TLS-1.0:DHE_RSA_3DES_EDE_CBC_SHA:24) (Exim 4.34) id 1EecDL-0003tT-UR for emacs-devel@gnu.org; Tue, 22 Nov 2005 12:45:56 -0500 Original-Received: from gnu.uvm.edu (gnu.uvm.edu [132.198.101.64]) by pony.uvm.edu (8.13.5/8.13.5) with ESMTP id jAMHjrtK018018 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO) for ; Tue, 22 Nov 2005 12:45:53 -0500 X-X-Sender: ashawley@gnu.uvm.edu Original-To: emacs-devel@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:46443 Archived-At: log-view is pretty cool. it should be documented. A proposal is below. It is copied (via Kill and Yank) from the commands documented for the "annotate buffer", found in the "Old Versions" section of the manual. --- files.texi 18 Nov 2005 13:54:05 -0500 1.122 +++ files.texi 22 Nov 2005 12:32:38 -0500 @@ -1790,8 +1790,50 @@ @findex vc-print-log 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. +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 was currently visited. + +From the change log buffer, the following keys can be used to move +between the logs of files and revisions, to view past revisions, and +to view diffs: + +@itemize @bullet + +@item +Pressing @kbd{p} moves to the previous revision of the file. It also +takes a numeric prefix argument, so for example @kbd{C-u 10 p} would +take you back 10 revisions. + +@item +Pressing @kbd{n} moves to the next revision of the file. It also +takes a numeric prefix argument, so for example @kbd{C-u 10 n} would +take you forward 10 revisions. + +@item +Pressing @kbd{f} visits the revision at the current line, like typing +@kbd{C-x v ~} and specifying the revision. + +@item +Pressing @kbd{d} shows the diff of the revision at line with its +previous revision. This is useful to see what actually changed when +the revision denoted on the current line was committed. + +@item +Pressing @kbd{P} moves 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, so for example @kbd{C-u 10 P} would take you +back 10 files. + +@item +Pressing @kbd{N} moves to the log of the next file if there are logs +for multiple files in the log buffer (@pxref{VC Dired Mode}). +Otherwise, it moves to the end of the log. It also takes a numeric +prefix argument, so for example @kbd{C-u 10 N} would take you forward +10 files. + +@end itemize @node VC Undo @subsubsection Undoing Version Control Actions