Author: kkolinko
Date: Tue Aug 2 09:38:38 2011
New Revision: 1153083
URL: http://svn.apache.org/viewvc?rev=1153083&view=rev
Log:
CTR: docs
Clarify rules on setting the path attribute on Context elements when defined in
server.xml
It is backport of Mark's r1150070.
Modified:
tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml
tomcat/tc6.0.x/trunk/webapps/docs/config/context.xml
Modified: tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml
URL:
http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml?rev=1153083&r1=1153082&r2=1153083&view=diff
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/changelog.xml Tue Aug 2 09:38:38 2011
@@ -333,6 +333,11 @@
<update>
Improve class loading documentation. (kkolinko)
</update>
+ <update>
+ Update documentation to be even more explicit about the implications
+ of setting the <code>path</code> attribute on a <code>Context</code>
+ element in <code>server.xml</code>. (markt/kkolinko)
+ </update>
</changelog>
</subsection>
<subsection name="Other">
Modified: tomcat/tc6.0.x/trunk/webapps/docs/config/context.xml
URL:
http://svn.apache.org/viewvc/tomcat/tc6.0.x/trunk/webapps/docs/config/context.xml?rev=1153083&r1=1153082&r2=1153083&view=diff
==============================================================================
--- tomcat/tc6.0.x/trunk/webapps/docs/config/context.xml (original)
+++ tomcat/tc6.0.x/trunk/webapps/docs/config/context.xml Tue Aug 2 09:38:38
2011
@@ -220,9 +220,15 @@
If you specify a context path of an empty string (""), you are
defining the <em>default</em> web application for this Host, which
will process all requests not assigned to other Contexts.</p>
- <p>The value of this field must not be set except when statically
- defining a Context in server.xml, as it will be inferred from the
- filenames used for either the .xml context file or the docBase.</p>
+ <p>This attribute must only be used when statically defining a Context
+ in server.xml. In all other circumstances, the path will be inferred
+ from the filenames used for either the .xml context file or the
docBase.
+ </p>
+ <p>Even when statically defining a Context in server.xml, this
attribute
+ must not be set unless either the docBase is not located under the
+ <a href="host.html">Host</a>'s <code>appBase</code> or both
+ <code>deployOnStartup</code> and <code>autoDeploy</code> are false. If
+ this rule is not followed, double deployment is likely to result.</p>
</attribute>
<attribute name="reloadable" required="false">
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
