You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by kk...@apache.org on 2011/11/10 03:57:07 UTC
svn commit: r1200106 - /tomcat/trunk/webapps/docs/config/filter.xml
Author: kkolinko
Date: Thu Nov 10 02:57:07 2011
New Revision: 1200106
URL: http://svn.apache.org/viewvc?rev=1200106&view=rev
Log:
Reformat and rearrange code samples to reduce the width of the document,
for better readability.
Modified:
tomcat/trunk/webapps/docs/config/filter.xml
Modified: tomcat/trunk/webapps/docs/config/filter.xml
URL: http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/config/filter.xml?rev=1200106&r1=1200105&r2=1200106&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/config/filter.xml (original)
+++ tomcat/trunk/webapps/docs/config/filter.xml Thu Nov 10 02:57:07 2011
@@ -380,16 +380,7 @@ The expiry time can be fine-tuned by add
<code>Cache-Control:max-age=</code> headers can be unnecessarily tricky to
understand.
</p>
- <p>
- <i>Sample : exclude response status codes 302, 500 and 503</i>
- </p>
-
- <source>
-<init-param>
- <param-name>ExpiresExcludedResponseStatusCodes</param-name>
- <param-value>302, 500, 503</param-value>
-</init-param>
- </source>
+ <p><i>See sample below the table</i></p>
</attribute>
<attribute name="ExpiresByType <content-type>" required="false">
@@ -429,22 +420,7 @@ The expiry time can be fine-tuned by add
configuration of an expiration with a charset must <strong>not</strong> include
such a space character.
</p>
- <p>
- <i>Sample:</i>
- </p>
-
- <source>
-<init-param>
- <param-name>ExpiresByType text/html</param-name>
- <param-value>access plus 1 month 15 days 2 hours</param-value>
-</init-param>
-
-<init-param>
- <!-- 2592000 seconds = 30 days -->
- <param-name>ExpiresByType image/gif</param-name>
- <param-value>A2592000</param-value>
-</init-param>
- </source>
+ <p><i>See sample below the table</i></p>
<p>
It overrides, for the specified MIME type <i>only</i>, any
expiration date set by the <code>ExpiresDefault</code> directive.
@@ -467,6 +443,30 @@ The expiry time can be fine-tuned by add
</attribute>
</attributes>
+ <p><i>Sample : exclude response status codes 302, 500 and 503</i></p>
+
+<source>
+<init-param>
+ <param-name>ExpiresExcludedResponseStatusCodes</param-name>
+ <param-value>302, 500, 503</param-value>
+</init-param>
+</source>
+
+ <p><i>Sample for ExpiresByType initialization parameter</i></p>
+
+ <source>
+<init-param>
+ <param-name>ExpiresByType text/html</param-name>
+ <param-value>access plus 1 month 15 days 2 hours</param-value>
+</init-param>
+
+<init-param>
+ <!-- 2592000 seconds = 30 days -->
+ <param-name>ExpiresByType image/gif</param-name>
+ <param-value>A2592000</param-value>
+</init-param>
+ </source>
+
</subsection>
<subsection name="Troubleshooting">
@@ -497,12 +497,14 @@ FINE: Filter initialized with configurat
</source>
<p>
Sample of per-request log message where <code>ExpiresFilter</code> adds an
- expiration date:
+ expiration date is below. The message is on one line and is wrapped here
+ for better readability.
</p>
<source>
Mar 26, 2010 2:09:47 PM org.apache.catalina.filters.ExpiresFilter onBeforeWriteResponseBody
-FINE: Request "/tomcat.gif" with response status "200" content-type "image/gif", set expiration date 3/26/10 2:19 PM
+FINE: Request "/tomcat.gif" with response status "200"
+ content-type "image/gif", set expiration date 3/26/10 2:19 PM
</source>
<p>
Sample of per-request log message where <code>ExpiresFilter</code> does not add
@@ -511,7 +513,8 @@ FINE: Request "/tomcat.gif" with respons
<source>
Mar 26, 2010 2:10:27 PM org.apache.catalina.filters.ExpiresFilter onBeforeWriteResponseBody
-FINE: Request "/docs/config/manager.html" with response status "200" content-type "text/html", no expiration configured
+FINE: Request "/docs/config/manager.html" with response status "200"
+ content-type "text/html", no expiration configured
</source>
</subsection>
@@ -580,7 +583,7 @@ FINE: Request "/docs/config/manager.html
<subsection name="Example">
<p>To allow access only for the clients connecting from localhost:</p>
-<pre>
+<source>
<filter>
<filter-name>Remote Address Filter</filter-name>
<filter-class>org.apache.catalina.filters.RemoteAddrFilter</filter-class>
@@ -593,7 +596,7 @@ FINE: Request "/docs/config/manager.html
<filter-name>Remote Address Filter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
-</pre>
+</source>
</subsection>
</section>
@@ -1122,7 +1125,8 @@ FINE: Request "/docs/config/manager.html
1request-dumper.org.apache.juli.FileHandler.prefix = request-dumper.
1request-dumper.org.apache.juli.FileHandler.formatter = org.apache.juli.VerbatimFormatter
org.apache.catalina.filters.RequestDumperFilter.level = INFO
-org.apache.catalina.filters.RequestDumperFilter.handlers = 1request-dumper.org.apache.juli.FileHandler
+org.apache.catalina.filters.RequestDumperFilter.handlers = \
+ 1request-dumper.org.apache.juli.FileHandler
</source>
</subsection>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org