Bugzilla 39883: add documentation warning about the use of antiResourceLocking on...

git-svn-id: https://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk@522286 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/webapps/docs/changelog.xml b/webapps/docs/changelog.xml
index 90060b3..e8cb9d2 100644 (file)
--- a/webapps/docs/changelog.xml
+++ b/webapps/docs/changelog.xml
@@ -40,6 +40,10 @@
         <bug>41752</bug> Correct error message on exception in MemoryRealm.
         (markt)
       </fix>
+      <update>
+        <bug>39883</bug> Add documentation warning about using antiResourceLocking
+        on a webapp outside the Host's appBase. (yoavs)
+      </update>
     </changelog>
   </subsection>
   <subsection name="Coyote">

diff --git a/webapps/docs/config/context.xml b/webapps/docs/config/context.xml
index 828cdf4..7615c5d 100644 (file)
--- a/webapps/docs/config/context.xml
+++ b/webapps/docs/config/context.xml
@@ -241,6 +241,15 @@
         including the disabling of JSP reloading in a running server: see
         <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37668">Bugzilla 37668</a>.
         </p>
+
+        <p>
+        Please note that setting this flag to true in applications that are
+        outside the appBase for the Host (the <code>webapps</code> directory
+        by default) will cause the application to be
+        <strong>deleted</strong> on Tomcat shutdown.  You probably don't want to
+        do this, so think twice before setting antiResourceLocking=true on a webapp
+        that's outside the appBase for its Host.
+        </p>
       </attribute>
 
       <attribute name="cacheMaxSize" required="false">