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

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


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

commit 189d18a2f72315b682df245d099b7d8aec181825
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 293a35b58e..97a663f2a4 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -160,6 +160,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>
   <subsection name="Other">
diff --git a/webapps/docs/config/valve.xml b/webapps/docs/config/valve.xml
index ea1745d64f..a7324b41a7 100644
--- a/webapps/docs/config/valve.xml
+++ b/webapps/docs/config/valve.xml
@@ -2551,16 +2551,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