[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