Adds LogFormat example to the split-logfiles documentation to clarify

what is meant about using %v

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@684308 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/programs/other.html.en b/docs/manual/programs/other.html.en
index 5a8f555fb90bdbcea1454b140154d627571a8871..c4bf2f592b2c930303b8831d7e38e11a0314a21e 100644 (file)
--- a/docs/manual/programs/other.html.en
+++ b/docs/manual/programs/other.html.en
@@ -43,15 +43,27 @@
 <h2><a name="split-logfile" id="split-logfile">split-logfile</a></h2>
     <p>This perl script will take a combined Web server access log file and
     break its contents into separate files. It assumes that the first field of
-    each line is the virtual host identity (put there by "<code>%v</code>"), and
-    that the logfiles should be named that + "<code>.log</code>" in the current
-    directory.</p>
+    each line is the virtual host identity, put there using the "<code>%v</code>"
+    variable in <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code>.
+    </p>
+
+    <div class="example"><p><code>
+        LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""
+             combined_plus_vhost<br />
+        CustomLog logs/access_log combined_plus_vhost
+    </code></p></div>
+    
+    <p>Log files will be created, in the directory where are running the
+    script, for each virtual host name that appears in the combined log file. 
+    These logfiles will named after the hostname, with a
+    <code>.log</code> file extension.</p>
 
     <p>The combined log file is read from stdin. Records read will be appended
     to any existing log files.</p>
 
     <div class="example"><p><code>split-logfile &lt; access_log</code></p></div>
 
+
 </div></div>
 <div class="bottomlang">
 <p><span>Available Languages: </span><a href="../en/programs/other.html" title="English">&nbsp;en&nbsp;</a> |
@@ -59,4 +71,4 @@
 </div><div id="footer">
 <p class="apache">Copyright 2008 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
-</body></html>
\ No newline at end of file
+</body></html>

diff --git a/docs/manual/programs/other.xml b/docs/manual/programs/other.xml
index bc2402e775982fa250ada92200adee730c82b1d4..8fe9700401b04bdb61e208ac0898ed6ce6e66822 100644 (file)
--- a/docs/manual/programs/other.xml
+++ b/docs/manual/programs/other.xml
@@ -43,15 +43,27 @@
 <section id="split-logfile"><title>split-logfile</title>
     <p>This perl script will take a combined Web server access log file and
     break its contents into separate files. It assumes that the first field of
-    each line is the virtual host identity (put there by "<code>%v</code>"), and
-    that the logfiles should be named that + "<code>.log</code>" in the current
-    directory.</p>
+    each line is the virtual host identity, put there using the "<code>%v</code>"
+    variable in <directive module="mod_log_config">LogFormat</directive>.
+    </p>
+
+    <example>
+        LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-agent}i\""
+             combined_plus_vhost<br />
+        CustomLog logs/access_log combined_plus_vhost
+    </example>
+    
+    <p>Log files will be created, in the directory where are running the
+    script, for each virtual host name that appears in the combined log file. 
+    These logfiles will named after the hostname, with a
+    <code>.log</code> file extension.</p>
 
     <p>The combined log file is read from stdin. Records read will be appended
     to any existing log files.</p>
 
     <example>split-logfile &lt; access_log</example>
 
+
 </section>
 
 </manualpage>