Document the ability to look at original of final subrequest.

I'd appreciate a review from someone more familiar with
mod_log_config!

PR: 27319

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

diff --git a/docs/manual/mod/mod_log_config.html.en b/docs/manual/mod/mod_log_config.html.en
index dcb0026b4be6d156234c19b96556fb340bd0f33c..0ea63a07e424fa80b24aefe5a7ebf8862d666483 100644 (file)
--- a/docs/manual/mod/mod_log_config.html.en
+++ b/docs/manual/mod/mod_log_config.html.en
@@ -187,6 +187,17 @@
     "%!200,304,302{Referer}i" logs <code>Referer:</code> on all requests
     which did <em>not</em> return some sort of normal status.</p>
 
+    <p>The modifiers "&lt;" and "&gt;" can be used for requests that
+    have been internally redirected to choose whether the original or
+    final (respectively) request should be consulted.  By default, the
+    <code>%</code> directives <code>%s, %U, %T, %D,</code> and
+    <code>%r</code> look at the original request while all others look
+    at the final request.  So for example, <code>%&gt;s</code> can be
+    used to record the final status of the request and
+    <code>%&lt;u</code> can be used to record the original
+    authenticated user on a request that is internally redirect to an
+    unauthenticated resource.</p>
+
     <p>Note that in httpd 2.0 versions prior to 2.0.46, no escaping was performed
     on the strings from <code>%...r</code>, <code>%...i</code> and
     <code>%...o</code>. This was mainly to comply with the requirements of

diff --git a/docs/manual/mod/mod_log_config.xml b/docs/manual/mod/mod_log_config.xml
index e9c328175cb0e633d2fe49c00db76cfe23cda2f7..2942cdeb7b363665adb1dafa0e2fa4c47471dffa 100644 (file)
--- a/docs/manual/mod/mod_log_config.xml
+++ b/docs/manual/mod/mod_log_config.xml
@@ -209,6 +209,17 @@
     "%!200,304,302{Referer}i" logs <code>Referer:</code> on all requests
     which did <em>not</em> return some sort of normal status.</p>
 
+    <p>The modifiers "&lt;" and "&gt;" can be used for requests that
+    have been internally redirected to choose whether the original or
+    final (respectively) request should be consulted.  By default, the
+    <code>%</code> directives <code>%s, %U, %T, %D,</code> and
+    <code>%r</code> look at the original request while all others look
+    at the final request.  So for example, <code>%&gt;s</code> can be
+    used to record the final status of the request and
+    <code>%&lt;u</code> can be used to record the original
+    authenticated user on a request that is internally redirect to an
+    unauthenticated resource.</p>
+
     <p>Note that in httpd 2.0 versions prior to 2.0.46, no escaping was performed
     on the strings from <code>%...r</code>, <code>%...i</code> and
     <code>%...o</code>. This was mainly to comply with the requirements of