(tomcat) branch 9.0.x updated: Expand the description of the %S (session ID) access log pattern token

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 cdab38262d Expand the description of the %S (session ID) access log pattern token
cdab38262d is described below

commit cdab38262d4be07d5507580c8a894f01ab5f3dcc
Author: Mark Thomas <[email protected]>
AuthorDate: Wed Aug 5 08:09:04 2026 +0100

    Expand the description of the %S (session ID) access log pattern token
---
 webapps/docs/changelog.xml    | 4 ++++
 webapps/docs/config/valve.xml | 2 +-
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 7002dcced3..162ab6475a 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -248,6 +248,10 @@
         to prevent a malicious client triggering excessive memory usage that
         could lead to a DoS. (markt)
       </fix>
+      <fix>
+        Documentation: Expand the description of the <code>%S</code> (session ID)
+        access log pattern token. (markt)
+      </fix>
     </changelog>
   </subsection>
   <subsection name="Other">
diff --git a/webapps/docs/config/valve.xml b/webapps/docs/config/valve.xml
index ef9a9e76fd..1160fc9805 100644
--- a/webapps/docs/config/valve.xml
+++ b/webapps/docs/config/valve.xml
@@ -304,7 +304,7 @@
     <li><b><code>%q</code></b> - Query string (prepended with a '?' if it exists)</li>
     <li><b><code>%r</code></b> - First line of the request (method and request URI)</li>
     <li><b><code>%s</code></b> - HTTP status code of the response</li>
-    <li><b><code>%S</code></b> - User session ID</li>
+    <li><b><code>%S</code></b> - User session ID, if a valid session exists when the access log entry is written</li>
     <li><b><code>%t</code></b> - Date and time, in Common Log Format</li>
     <li><b><code>%T</code></b> - Time taken to process the request, in seconds. Note: This
         value has millisecond resolution whereas in httpd it has