[svnbook] r3962 committed - No longer represent high-level logging as Apache-only....

svnbook at googlecode.com svnbook at googlecode.com
Mon Aug 8 12:41:45 CDT 2011


Revision: 3962
Author:   cmpilato at gmail.com
Date:     Mon Aug  8 10:41:03 2011
Log:      No longer represent high-level logging as Apache-only.

* src/en/book/ch09-reference.xml
   (svn.ref.svnserve.sw): Point folks to new high-level logging
     section.
   (svn.ref.mod_dav_svn.conf.logging): Move high-level logging details
     from here...

* src/en/book/ch06-server-configuration.xml
   (svn.serverconfig.operational-logging): ... to here.
   (svn.serverconfig.httpd.extra.logging): Update xref per the
     aforementioned relocation of logging details.
http://code.google.com/p/svnbook/source/detail?r=3962

Modified:
  /trunk/src/en/book/ch06-server-configuration.xml
  /trunk/src/en/book/ch09-reference.xml

=======================================
--- /trunk/src/en/book/ch06-server-configuration.xml	Fri Aug  5 20:01:09  
2011
+++ /trunk/src/en/book/ch06-server-configuration.xml	Mon Aug  8 10:41:03  
2011
@@ -2937,7 +2937,7 @@
            multiple repositories into a single log file.</para>

          <para>For an exhaustive list of all actions logged, see <xref
-          linkend="svn.ref.mod_dav_svn.conf.logging"/>.</para>
+          linkend="svn.serverconfig.operational-logging"/>.</para>

        </sect3>

@@ -3666,6 +3666,183 @@
          partway through.</para>
      </sidebar>

+  </sect1>
+
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <!-- =================================================================  
-->
+  <sect1 id="svn.serverconfig.operational-logging">
+    <title>High-level Logging</title>
+
+    <para>Both the Apache <command>httpd</command>
+      and <command>svnserve</command> Subversion servers provide
+      support for high-level logging of Subversion operations.
+      Configuring each of the server options to provide this level of
+      logging is done differently, of course, but the output from each
+      is designed to conform to a uniform syntax.</para>
+
+    <para>To enable high-level logging in <command>svnserve</command>,
+      you need only use the <option>--log-file</option> command-line
+      option when starting the server, passing as the value to the
+      option the file to which <command>svnserve</command> should
+      write its log output.</para>
+
+    <informalexample>
+      <screen>
+$ svnserve -d -r /path/to/repositories --log-file /var/log/svn.log
+</screen>
+    </informalexample>
+
+    <para>Enabling the same in Apache is a bit more involved, but is
+      essentially an extension of Apache's stock log output
+      configuration mechanisms—see
+      <xref linkend="svn.serverconfig.httpd.extra.logging"/> for
+      details.</para>
+
+    <para>The following is a list of Subversion action log messages
+      produced by its high-level logging mechanism, followed by one or
+      more examples of the log message as it appears in the log
+      output.</para>
+
+    <variablelist>
+      <varlistentry>
+        <term>Checkout or export</term>
+        <listitem>
+          <programlisting>
+checkout-or-export /path r62 depth=infinity
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Commit</term>
+        <listitem>
+          <programlisting>
+commit harry r100
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Diffs</term>
+        <listitem>
+          <programlisting>
+diff /path r15:20 depth=infinity ignore-ancestry
+diff /path1 at 15 /path2 at 20 depth=infinity ignore-ancestry
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Fetch a directory</term>
+        <listitem>
+          <programlisting>
+get-dir /trunk r17 text
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Fetch a file</term>
+        <listitem>
+          <programlisting>
+get-file /path r20 props
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Fetch a file revision</term>
+        <listitem>
+          <programlisting>
+get-file-revs /path r12:15 include-merged-revisions
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Fetch merge information</term>
+        <listitem>
+          <programlisting>
+get-mergeinfo (/path1 /path2)
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Lock</term>
+        <listitem>
+          <programlisting>
+lock /path steal
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Log</term>
+        <listitem>
+          <programlisting>
+log (/path1,/path2,/path3) r20:90 discover-changed-paths revprops=()
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Replay revisions (svnsync)</term>
+        <listitem>
+          <programlisting>
+replay /path r19
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Revision property change</term>
+        <listitem>
+          <programlisting>
+change-rev-prop r50 propertyname
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Revision property list</term>
+        <listitem>
+          <programlisting>
+rev-proplist r34
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Status</term>
+        <listitem>
+          <programlisting>
+status /path r62 depth=infinity
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Switch</term>
+        <listitem>
+          <programlisting>
+switch /pathA /pathB at 50 depth=infinity
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Unlock</term>
+        <listitem>
+          <programlisting>
+unlock /path break
+</programlisting>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term>Update</term>
+        <listitem>
+          <programlisting>
+update /path r17 send-copyfrom-args
+</programlisting>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+    <para>As a convenience to administrators who wish to post-process
+      their Subversion high-level logging output (perhaps for
+      reporting or analysis purposes), Subversion source code
+      distributions provide a Python module (located at
+      <filename>tools/server-side/svn_server_log_parse.py</filename>)
+      which can be used to parse Subversion's log output.</para>
+
    </sect1>

    <!-- =================================================================  
-->
=======================================
--- /trunk/src/en/book/ch09-reference.xml	Thu Aug  4 06:41:36 2011
+++ /trunk/src/en/book/ch09-reference.xml	Mon Aug  8 10:41:03 2011
@@ -8883,12 +8883,9 @@
                necessary) and use the file located
                at <replaceable>FILENAME</replaceable> for Subversion
                operational log output of the same sort
-              that <command>mod_dav_svn</command> generates.</para>
-              <!-- ### TODO: Add xref to book section on operational
-                   logging, but only after that section exists.  (The
-                   material exists at svn.serverconfig.httpd.extra.logging,
-                   but needs to be abstracted out of the current
-                   Apache-only coverage. -->
+              that <command>mod_dav_svn</command> generates.  See
+              <xref linkend="svn.serverconfig.operational-logging" />
+              for details.</para>
            </listitem>
          </varlistentry>

@@ -9693,139 +9690,6 @@

          </variablelist>
        </refsect1>
-
-      <refsect1 id="svn.ref.mod_dav_svn.conf.logging">
-        <title>High-level logging</title>
-
-        <para>This is a list of Subversion action log messages
-          produced by Apache's high-level logging mechanism, followed
-          by an example of the log message.  See <xref
-          linkend="svn.serverconfig.httpd.extra.logging"/> for details
-          on logging.</para>
-
-        <variablelist>
-
-          <varlistentry>
-            <term>Checkout or export</term>
-            <listitem>
-              <para><literal>checkout-or-export /path r62
-            depth=infinity</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Commit</term>
-            <listitem>
-              <para><literal>commit harry r100</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Diffs</term>
-            <listitem>
-              <para><literal>diff /path r15:20 depth=infinity  
ignore-ancestry</literal></para>
-              <para><literal>diff /path1 at 15 /path2 at 20 depth=infinity  
ignore-ancestry</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Fetch a directory</term>
-            <listitem>
-              <para><literal>get-dir /trunk r17 text</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Fetch a file</term>
-            <listitem>
-              <para><literal>get-file /path r20 props</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Fetch a file revision</term>
-            <listitem>
-              <para><literal>get-file-revs /path r12:15  
include-merged-revisions</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Fetch merge information</term>
-            <listitem>
-              <para><literal>get-mergeinfo (/path1 /path2)</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Lock</term>
-            <listitem>
-              <para><literal>lock /path steal</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Log</term>
-            <listitem>
-              <para><literal>log (/path1,/path2,/path3) r20:90
-            discover-changed-paths revprops=()</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Replay revisions (svnsync)</term>
-            <listitem>
-              <para><literal>replay /path r19</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Revision property change</term>
-            <listitem>
-              <para><literal>change-rev-prop r50
-            propertyname</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Revision property list</term>
-            <listitem>
-              <para><literal>rev-proplist r34</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Status</term>
-            <listitem>
-              <para><literal>status /path r62
-                depth=infinity</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Switch</term>
-            <listitem>
-              <para><literal>switch /pathA /pathB at 50  
depth=infinity</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Unlock</term>
-            <listitem>
-              <para><literal>unlock /path break</literal></para>
-            </listitem>
-          </varlistentry>
-
-          <varlistentry>
-            <term>Update</term>
-            <listitem>
-              <para><literal>update /path r17  
send-copyfrom-args</literal></para>
-            </listitem>
-          </varlistentry>
-
-        </variablelist>
-
-      </refsect1>
-
      </refentry>
    </sect1>





More information about the svnbook-dev mailing list