[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