(tomcat) branch 10.1.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 10.1.x
in repository https://gitbox.apache.org/repos/asf/tomcat.git


The following commit(s) were added to refs/heads/10.1.x by this push:
     new ee0eea8066 Expand the description of the %S (session ID) access log pattern token
ee0eea8066 is described below

commit ee0eea8066365494819bbd35a038a00c4993d1d6
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 403b7e20ce..0013fdfb87 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 3c7a680f9c..b7127d935b 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>