From f40a38bfe8c31dd57f18cca4133bb4cebcb19eda Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Thu, 22 Sep 2011 00:25:48 +0000
Subject: [PATCH] Pulls the examples out of the paragraph text and into a table
so that they are more visually distinct.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1173918 13f79535-47bb-0310-9956-ffa450edef68
---
docs/manual/mod/mod_log_config.html.en | 26 ++++++++++++++-------
docs/manual/mod/mod_log_config.xml | 32 +++++++++++++++++++-------
2 files changed, 42 insertions(+), 16 deletions(-)
diff --git a/docs/manual/mod/mod_log_config.html.en b/docs/manual/mod/mod_log_config.html.en
index 0262667ba1..d70877d62f 100644
--- a/docs/manual/mod/mod_log_config.html.en
+++ b/docs/manual/mod/mod_log_config.html.en
@@ -220,14 +220,22 @@
<p>Particular items can be restricted to print only for
responses with specific HTTP status codes by placing a
comma-separated list of status codes immediately following the
- "%". For example, <code>"%400,501{User-agent}i"</code> logs
- <code>User-agent</code> on 400 errors and 501 errors only. For
+ "%". The status code list may be peceded by a "<code>!</code>" to
+ indicate negation.</p>
+
+ <table class="bordered"><tr class="header"><th>Format String</th>
+ <th>Meaning</th></tr>
+<tr>
+ <td><code>%400,501{User-agent}i</code></td>
+ <td>Logs <code>User-agent</code> on 400 errors and 501 errors only. For
other status codes, the literal string <code>"-"</code> will be
- logged. The status code list may be preceded by a
- "<code>!</code>" to indicate negation:
- <code>"%!200,304,302{Referer}i"</code> logs <code>Referer</code>
- on all requests that do <em>not</em> return one of the three
- specified codes.</p>
+ logged.</td></tr>
+<tr class="odd"><td><code>%!200,304,302{Referer}i</code></td>
+ <td>Logs <code>Referer</code> on all requests that do
+ <em>not</em> return one of the three specified codes,
+ "<code>-</code>" otherwise.
+ </td></tr>
+</table>
<p>The modifiers "<" and ">" can be used for requests that
have been internally redirected to choose whether the original
@@ -242,7 +250,7 @@
- <h3><a name="format-notes" id="format-notes">Some Notes</a></h3>
+ <h3><a name="format-notes" id="format-notes">Format Notes</a></h3>
<p>For security reasons, starting with version 2.0.46,
non-printable and other special characters in <code>%r</code>,
@@ -264,10 +272,12 @@
format provided by <code class="module"><a href="../mod/mod_logio.html">mod_logio</a></code> will log the
actual number of bytes sent over the network.</p>
+ <div class="note">
<p>Note: <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> is implemented as a
quick-handler and not as a standard handler. Therefore, the
<code>%R</code> format string will not return any handler
information when content caching is involved.</p>
+ </div>
diff --git a/docs/manual/mod/mod_log_config.xml b/docs/manual/mod/mod_log_config.xml
index edfd6fc517..ed7d15aa00 100644
--- a/docs/manual/mod/mod_log_config.xml
+++ b/docs/manual/mod/mod_log_config.xml
@@ -246,14 +246,28 @@
<p>Particular items can be restricted to print only for
responses with specific HTTP status codes by placing a
comma-separated list of status codes immediately following the
- "%". For example, <code>"%400,501{User-agent}i"</code> logs
- <code>User-agent</code> on 400 errors and 501 errors only. For
+ "%". The status code list may be peceded by a "<code>!</code>" to
+ indicate negation.</p>
+
+ <table border="1" style="zebra">
+ <columnspec><column width=".2"/><column width=".8"/></columnspec>
+
+ <tr><th>Format String</th>
+ <th>Meaning</th></tr>
+
+ <tr>
+ <td><code>%400,501{User-agent}i</code></td>
+ <td>Logs <code>User-agent</code> on 400 errors and 501 errors only. For
other status codes, the literal string <code>"-"</code> will be
- logged. The status code list may be preceded by a
- "<code>!</code>" to indicate negation:
- <code>"%!200,304,302{Referer}i"</code> logs <code>Referer</code>
- on all requests that do <em>not</em> return one of the three
- specified codes.</p>
+ logged.</td></tr>
+
+ <tr><td><code>%!200,304,302{Referer}i</code></td>
+ <td>Logs <code>Referer</code> on all requests that do
+ <em>not</em> return one of the three specified codes,
+ "<code>-</code>" otherwise.
+ </td></tr>
+
+ </table>
<p>The modifiers "<" and ">" can be used for requests that
have been internally redirected to choose whether the original
@@ -268,7 +282,7 @@
</section>
- <section id="format-notes"><title>Some Notes</title>
+ <section id="format-notes"><title>Format Notes</title>
<p>For security reasons, starting with version 2.0.46,
non-printable and other special characters in <code>%r</code>,
@@ -290,10 +304,12 @@
format provided by <module>mod_logio</module> will log the
actual number of bytes sent over the network.</p>
+ <note>
<p>Note: <module>mod_cache</module> is implemented as a
quick-handler and not as a standard handler. Therefore, the
<code>%R</code> format string will not return any handler
information when content caching is involved.</p>
+ </note>
</section>
--
2.40.0