From: Rich Bowen <rbowen@apache.org>
Date: Sat, 9 Aug 2008 17:56:14 +0000 (+0000)
Subject: Adds LogFormat example to the split-logfiles documentation to clarify
X-Git-Tag: 2.3.0~387
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=e2d449fccb3a0100a8dc38595edfa24b1c61cb87;p=thirdparty%2Fapache%2Fhttpd.git

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 5a8f555fb90..c4bf2f592b2 100644
--- 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 bc2402e7759..8fe9700401b 100644
--- 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>