Update documentation for restrictedUserAgents, noCompressionUserAgents attributes...

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

diff --git a/java/org/apache/coyote/http11/AbstractHttp11Processor.java b/java/org/apache/coyote/http11/AbstractHttp11Processor.java
index 3805640..765c79b 100644 (file)
--- a/java/org/apache/coyote/http11/AbstractHttp11Processor.java
+++ b/java/org/apache/coyote/http11/AbstractHttp11Processor.java
@@ -122,7 +122,7 @@ public abstract class AbstractHttp11Processor implements ActionHook, Processor {
 
 
     /**
-     * List of restricted user agents.
+     * Regular expression that defines the restricted user agents.
      */
     protected Pattern restrictedUserAgents = null;
 
@@ -211,7 +211,7 @@ public abstract class AbstractHttp11Processor implements ActionHook, Processor {
 
 
     /**
-     * List of user agents to not use gzip with
+     * Regular expression that defines the user agents to not use gzip with
      */
     protected Pattern noCompressionUserAgents = null;
 

diff --git a/java/org/apache/coyote/http11/AbstractHttp11Protocol.java b/java/org/apache/coyote/http11/AbstractHttp11Protocol.java
index cb77d82..a90a279 100644 (file)
--- a/java/org/apache/coyote/http11/AbstractHttp11Protocol.java
+++ b/java/org/apache/coyote/http11/AbstractHttp11Protocol.java
@@ -115,8 +115,8 @@ public abstract class AbstractHttp11Protocol extends AbstractProtocolHandler {
 
 
     /**
-     * User agents regular expressions which should be restricted to HTTP/1.0
-     * support.
+     * Regular expression that defines the User agents which should be
+     * restricted to HTTP/1.0 support.
      */
     private String restrictedUserAgents = null;
     public String getRestrictedUserAgents() { return restrictedUserAgents; }

diff --git a/webapps/docs/config/http.xml b/webapps/docs/config/http.xml
index b5c72e5..4f819c5 100644 (file)
--- a/webapps/docs/config/http.xml
+++ b/webapps/docs/config/http.xml
@@ -383,8 +383,9 @@
     </attribute>
 
     <attribute name="noCompressionUserAgents" required="false">
-      <p>The value is a comma separated list of regular expressions matching
-      user-agents of HTTP clients for which compression should not be used,
+      <p>The value is a regular expression (using <code>java.util.regex</code>)
+      matching the <code>user-agent</code> header of HTTP clients for which
+      compression should not be used,
       because these clients, although they do advertise support for the
       feature, have a broken implementation.
       The default value is an empty String (regexp matching disabled).</p>
@@ -398,10 +399,10 @@
     </attribute>
       
     <attribute name="restrictedUserAgents" required="false">
-      <p>The value is a comma separated list of regular expressions matching
-      user-agents of HTTP clients for which HTTP/1.1 or HTTP/1.0 keep alive
-      should not be used, even if the clients advertise support for these
-      features.
+      <p>The value is a regular expression (using <code>java.util.regex</code>) matching
+      matching the <code>user-agent</code> header of HTTP clients for which
+      HTTP/1.1 or HTTP/1.0 keep alive should not be used, even if the clients
+      advertise support for these features.
       The default value is an empty String (regexp matching disabled).</p>
     </attribute>