You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by ma...@apache.org on 2011/04/18 13:20:02 UTC

svn commit: r1094492 - /tomcat/tc5.5.x/trunk/container/webapps/docs/config/context.xml

Author: markt
Date: Mon Apr 18 11:20:02 2011
New Revision: 1094492

URL: http://svn.apache.org/viewvc?rev=1094492&view=rev
Log:
Add note that antiJARLocking and antiResourceLocking should not be used together.
Line length

Modified:
    tomcat/tc5.5.x/trunk/container/webapps/docs/config/context.xml

Modified: tomcat/tc5.5.x/trunk/container/webapps/docs/config/context.xml
URL: http://svn.apache.org/viewvc/tomcat/tc5.5.x/trunk/container/webapps/docs/config/context.xml?rev=1094492&r1=1094491&r2=1094492&view=diff
==============================================================================
--- tomcat/tc5.5.x/trunk/container/webapps/docs/config/context.xml (original)
+++ tomcat/tc5.5.x/trunk/container/webapps/docs/config/context.xml Mon Apr 18 11:20:02 2011
@@ -274,9 +274,14 @@
       <attribute name="antiJARLocking" required="false">
         <p>If true, the Tomcat classloader will take extra measures to avoid
         JAR file locking when resources are accessed inside JARs through URLs.
-        This will impact startup time of applications, but could prove to be useful
-        on platforms or configurations where file locking can occur.
+        This will impact startup time of applications, but could prove to be
+        useful on platforms or configurations where file locking can occur.
         If not specified, the default value is <code>false</code>.</p>
+
+        <p><code>antiJARLocking</code> is a subset of
+        <code>antiResourceLocking</code> and therefore, to prevent duplicate
+        work and possible issues, only one of these attributes should be set
+        to <code>true</code> at any one time.</p>
       </attribute>
 
       <attribute name="antiResourceLocking" required="false">
@@ -286,18 +291,22 @@
         or configurations where file locking can occur.
         If not specified, the default value is <code>false</code>.</p>
    
-        <p>Please note that setting this to <code>true</code> has some side effects,
-        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
+        <p><code>antiJARLocking</code> is a subset of
+        <code>antiResourceLocking</code> and therefore, to prevent duplicate
+        work and possible issues, only one of these attributes should be set
+        to <code>true</code> at any one time.</p>
+
+        <p>Please note that setting this to <code>true</code> has some side
+        effects, 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>
+        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">



---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org