From 187f7f1d25a1905f85a7bb9ab79c681b57714588 Mon Sep 17 00:00:00 2001
From: fhanik <fhanik@13f79535-47bb-0310-9956-ffa450edef68>
Date: Thu, 11 Jun 2009 16:37:20 +0000
Subject: [PATCH] Document emptySessionPath behavior

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@783837 13f79535-47bb-0310-9956-ffa450edef68
---
 webapps/docs/config/http.xml | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/webapps/docs/config/http.xml b/webapps/docs/config/http.xml
index 2cc23e77c..8b1129ae6 100644
--- a/webapps/docs/config/http.xml
+++ b/webapps/docs/config/http.xml
@@ -79,7 +79,13 @@
     <attribute name="emptySessionPath" required="false">
       <p>If set to <code>true</code>, all paths for session cookies will be set
       to <code>/</code>. This can be useful for portlet specification implementations.
-      If not specified, this attribute is set to <code>false</code>.</p>
+      If not specified, this attribute is set to <code>false</code>.<br/>
+      A side effect to setting this to true, is that if Tomcat creates a new session it will attempt to use the 
+      cookie session id if supplied by the client.<br/>
+      <a href="http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/catalina/src/share/org/apache/catalina/connector/Request.java?diff_format=h&amp;view=log#rev303682">SVN check in</a><br/>
+      <a href="http://tomcat.markmail.org/search/?q=emptysessionpath%20reuse#query:emptysessionpath%20reuse%20date%3A200502%20+page:1+mid:2bocwjhn3cczsoii+state:results">Dev discussion</a><br/>
+      <a href="https://issues.apache.org/bugzilla/show_bug.cgi?id=47298">Work around</a>
+      </p>
     </attribute>
 
     <attribute name="enableLookups" required="false">
-- 
2.11.0