(tomcat) branch 11.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 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 2e1be78f56 Expand the description of the %S (session ID) access log pattern token
2e1be78f56 is described below

commit 2e1be78f5670bfc4511f8ee9846ec36e5058f1b3
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 52eb969b15..5757c8a9c2 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -252,6 +252,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 6f4e1e4b3a..1385ec3774 100644
--- a/webapps/docs/config/valve.xml
+++ b/webapps/docs/config/valve.xml
@@ -302,7 +302,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</li>
     <li><b><code>%u</code></b> - Remote user that was authenticated (if any), else '-' (escaped if required)</li>