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


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

commit f7457325d3615cceaa8243355f6ec5df7e53f467
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 173f38f99e..bca37d4370 100644
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -458,6 +458,10 @@
         and add a note that the exact configuration required will depend on the
         overall httpd configuration. (markt)
       </fix>
+      <fix>
+        Documentation: Expand the description of the <code>%S</code> (session ID)
+        access log pattern token. (markt)
+      </fix>
     </changelog>
   </subsection>
   <subsection name="jdbc-pool">
diff --git a/webapps/docs/config/valve.xml b/webapps/docs/config/valve.xml
index 52f1460458..5eac457a71 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>