[svnbook commit] r3090 - trunk/src/en/book
cmpilato
noreply at red-bean.com
Thu May 29 10:55:21 CDT 2008
Author: cmpilato
Date: Thu May 29 10:55:20 2008
New Revision: 3090
Log:
Document 'svn log -v', including a list of the action codes.
(Trac ticket #107.)
Modified:
trunk/src/en/book/ch09-reference.xml
Modified: trunk/src/en/book/ch09-reference.xml
==============================================================================
--- trunk/src/en/book/ch09-reference.xml (original)
+++ trunk/src/en/book/ch09-reference.xml Thu May 29 10:55:20 2008
@@ -2889,6 +2889,65 @@
…
</screen>
+ <para>The <option>--verbose</option> option causes
+ <command>svn log</command> to include information about
+ the paths that were changed in each displayed revision.
+ These paths appear, one path per line of output, with
+ action codes that indicate what type of change was made to
+ the path.</para>
+
+ <screen>
+$ svn log http://svn.red-bean.com/repos/test/ foo.c bar.c
+------------------------------------------------------------------------
+r32 | sally | 2003-01-13 00:43:13 -0600 (Mon, 13 Jan 2003) | 1 line
+Changed paths:
+ M /foo.c
+
+Added defines.
+------------------------------------------------------------------------
+r31 | harry | 2003-01-10 12:25:08 -0600 (Fri, 10 Jan 2003) | 1 line
+Changed paths:
+ A /bar.c
+
+Added new file bar.c
+------------------------------------------------------------------------
+r28 | sally | 2003-01-07 21:48:33 -0600 (Tue, 07 Jan 2003) | 3 lines
+…
+</screen>
+
+ <para>There are just a handful of action codes used by
+ <command>svn log</command>, and they are similar to the
+ ones used by the <command>svn update</command>
+ command:</para>
+
+ <variablelist>
+ <varlistentry>
+ <term><literal>A</literal></term>
+ <listitem><para>The item was added.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>D</literal></term>
+ <listitem><para>The item was deleted.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>M</literal></term>
+ <listitem><para>Properties or textual contents on the
+ item were changed.</para></listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>R</literal></term>
+ <listitem><para>The item was replaced by a different one
+ at the same location.</para></listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>In addition to the action codes which precede the
+ changed paths, <command>svn log --verbose</command> will
+ note a path was added or replaced as the result of a copy
+ operation. It does so by printing <literal>(from
+ <replaceable>COPY-FROM-PATH</replaceable>:<replaceable>COPY-FROM-REV</replaceable>)</literal>
+ after such paths.</para>
+
<para>When you're concatenating the results of multiple
calls to the log command, you may want to use the
<option>--incremental</option> option. <command>svn
@@ -2935,7 +2994,6 @@
in your output by using the <option>--incremental</option>
option:</para>
-
<screen>
$ svn log --incremental -r 14 > mylog
$ svn log --incremental -r 19 >> mylog
@@ -2955,8 +3013,6 @@
similar output control when using the
<option>--xml</option> option.</para>
-
-
<tip>
<para>If you run <command>svn log</command> on a specific
path and provide a specific revision and get no output
More information about the svnbook-dev
mailing list