This is an automated email from the ASF dual-hosted git repository.

markt-asf pushed a commit to branch 11.0.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git


The following commit(s) were added to refs/heads/11.0.x by this push:
     new 2012b79ecb Expand the CrawlerSessionManagerValve docs
2012b79ecb is described below

commit 2012b79ecb470a02536573c111413a64b3103d6f
Author: Mark Thomas <[email protected]>
AuthorDate: Mon May 18 11:58:25 2026 +0100

    Expand the CrawlerSessionManagerValve docs
---
 webapps/docs/changelog.xml    |  4 ++++
 webapps/docs/config/valve.xml | 17 ++++++++++++-----
 2 files changed, 16 insertions(+), 5 deletions(-)

diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 3226810031..d6bb65759d 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -168,6 +168,10 @@
         Manager: Add checks to ensure that the requested context path for a
         deployed WAR, directory or descriptor file is valid. (markt)
       </add>
+      <add>
+        Documentation: Expand the description of some of the attributes of the
+        <code>CrawlerSessionManagerValve</code>. (markt)
+      </add>
     </changelog>
   </subsection>
 </section>
diff --git a/webapps/docs/config/valve.xml b/webapps/docs/config/valve.xml
index 6ad322e86c..a3d4599ad8 100644
--- a/webapps/docs/config/valve.xml
+++ b/webapps/docs/config/valve.xml
@@ -2554,16 +2554,23 @@
       </attribute>
 
       <attribute name="crawlerIps" required="false">
-        <p>Regular expression (using <code>java.util.regex</code>) that client
-        IP is matched against to determine if a request is from a web crawler.
-        By default such regular expression is not set.</p>
+        <p>Regular expression (using <code>java.util.regex</code>) that the
+        client IP is matched against to determine if a request is from a web
+        crawler. An IP match alone is sufficient for the request to be
+        considered to be from a web crawler. It is not necessary for any other
+        check to indicate that the request is from a web crawler. By default
+        such regular expression is not set and no IP check is performed.</p>
       </attribute>
 
       <attribute name="crawlerUserAgents" required="false">
         <p>Regular expression (using <code>java.util.regex</code>) that the 
user
         agent HTTP request header is matched against to determine if a request
-        is from a web crawler. If not set, the default of
-        <code>.*[bB]ot.*|.*Yahoo! Slurp.*|.*Feedfetcher-Google.*</code> is 
used.</p>
+        is from a web crawler. An user agent match alone is sufficient for the
+        request to be considered to be from a web crawler. It is not necessary
+        for any other check to indicate that the request is from a web crawler.
+        If not set, the default of
+        <code>.*[bB]ot.*|.*Yahoo! Slurp.*|.*Feedfetcher-Google.*</code> is
+        used.</p>
       </attribute>
 
       <attribute name="hostAware" required="false">


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to