Return-Path: Delivered-To: apmail-tomcat-dev-archive@www.apache.org Received: (qmail 93469 invoked from network); 10 Oct 2008 11:46:22 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 10 Oct 2008 11:46:22 -0000 Received: (qmail 90282 invoked by uid 500); 10 Oct 2008 11:46:19 -0000 Delivered-To: apmail-tomcat-dev-archive@tomcat.apache.org Received: (qmail 90226 invoked by uid 500); 10 Oct 2008 11:46:19 -0000 Mailing-List: contact dev-help@tomcat.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Tomcat Developers List" Delivered-To: mailing list dev@tomcat.apache.org Received: (qmail 90213 invoked by uid 99); 10 Oct 2008 11:46:19 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 10 Oct 2008 04:46:19 -0700 X-ASF-Spam-Status: No, hits=-1999.9 required=10.0 tests=ALL_TRUSTED,DNS_FROM_SECURITYSAGE X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 10 Oct 2008 11:45:22 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 331FF23888AF; Fri, 10 Oct 2008 04:45:58 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r703421 - in /tomcat/container/tc5.5.x/webapps/docs/config: context.xml host.xml Date: Fri, 10 Oct 2008 11:45:58 -0000 To: dev@tomcat.apache.org From: markt@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20081010114558.331FF23888AF@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: markt Date: Fri Oct 10 04:45:57 2008 New Revision: 703421 URL: http://svn.apache.org/viewvc?rev=703421&view=rev Log: Update docs: clarify context.xml copying and multi-level contexts Modified: tomcat/container/tc5.5.x/webapps/docs/config/context.xml tomcat/container/tc5.5.x/webapps/docs/config/host.xml Modified: tomcat/container/tc5.5.x/webapps/docs/config/context.xml URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/config/context.xml?rev=703421&r1=703420&r2=703421&view=diff ============================================================================== --- tomcat/container/tc5.5.x/webapps/docs/config/context.xml (original) +++ tomcat/container/tc5.5.x/webapps/docs/config/context.xml Fri Oct 10 04:45:57 2008 @@ -67,20 +67,28 @@

Context elements may be explicitly defined:

in the $CATALINA_HOME/conf/context.xml file: - the Context element information will be loaded by all webapps
in the +
In the $CATALINA_HOME/conf/context.xml file: + the Context element information will be loaded by all webapps.
In the $CATALINA_HOME/conf/[enginename]/[hostname]/context.xml.default file: the Context element information will be loaded by all webapps of that - host
in individual files (with a ".xml" extension) in the + host.
In individual files (with a ".xml" extension) in the $CATALINA_HOME/conf/[enginename]/[hostname]/ directory. The name of the file (less the .xml) extension will be used as the context path. Multi-level context paths may be defined using #, e.g. - context#path.xml. The default web application may be defined - by using a file called ROOT.xml.
if the previous file was not found for this application, in an individual - file at /META-INF/context.xml inside the application files

foo#bar.xml

/foo/bar

ROOT.xml

Only if a context file does not exist for the application in the + $CATALINA_HOME/conf/[enginename]/[hostname]/; in an individual + file at /META-INF/context.xml inside the application files. If + the web application is packaged as a WAR then + /META-INF/context.xml will be copied to + $CATALINA_HOME/conf/[enginename]/[hostname]/ and renamed to + match the application's context path. Once this file exists, it will not be + replaced if a new WAR with a newer /META-INF/context.xml is + placed in the host's appBase.
inside a Host element in the main conf/server.xml

Modified: tomcat/container/tc5.5.x/webapps/docs/config/host.xml URL: http://svn.apache.org/viewvc/tomcat/container/tc5.5.x/webapps/docs/config/host.xml?rev=703421&r1=703420&r2=703421&view=diff ============================================================================== --- tomcat/container/tc5.5.x/webapps/docs/config/host.xml (original) +++ tomcat/container/tc5.5.x/webapps/docs/config/host.xml Fri Oct 10 04:45:57 2008 @@ -292,7 +292,9 @@ be sure to delete the expanded directory when restarting Tomcat, so that the updated WAR file will be re-expanded (note that the auto deployer, if enabled, will automatically expand the updated WAR file - once the previously expanded directory is removed). + once the previously expanded directory is removed). Multi-level contexts + may be defined by using #, eg use a WAR named foo#bar.war + for a context path of /foo/bar.

Any subdirectory within the application base directory will receive an automatically generated Context element, even if this directory is not mentioned in the @@ -301,7 +303,9 @@ defaults configured for this Host element. The context path for this deployed Context will be a slash character ("/") followed by the directory name, unless the directory name is ROOT, in which case - the context path will be an empty string ("").

+ the context path will be an empty string (""). Multi-level contexts + may be defined by using #, eg use a directory named foo#bar + for a context path of /foo/bar.

In addition to the automatic deployment that occurs at startup time, --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@tomcat.apache.org For additional commands, e-mail: dev-help@tomcat.apache.org