You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by cr...@apache.org on 2002/03/01 06:46:52 UTC
cvs commit: jakarta-tomcat-4.0/webapps/tomcat-docs/config host.xml
craigmcc 02/02/28 21:46:52
Modified: webapps/tomcat-docs/config host.xml
Log:
Tweak the auto-deployment documentation to reflect the current
functionality.
Revision Changes Path
1.9 +21 -15 jakarta-tomcat-4.0/webapps/tomcat-docs/config/host.xml
Index: host.xml
===================================================================
RCS file: /home/cvs/jakarta-tomcat-4.0/webapps/tomcat-docs/config/host.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- host.xml 25 Oct 2001 00:38:49 -0000 1.8
+++ host.xml 1 Mar 2002 05:46:52 -0000 1.9
@@ -73,7 +73,9 @@
<attribute name="autoDeploy" required="false">
<p>This flag value indicates if web applications from this host should
be automatically deployed by the host configurator.
- The flag's value defaults to true.</p>
+ The flag's value defaults to true. See
+ <a href="#Automatic Application Deployment">Automatic Application
+ Deployment</a> for more information.</p>
</attribute>
<attribute name="className" required="false">
@@ -117,18 +119,21 @@
<p>Java class name of the error reporting valve which will be used
by this Host. The responsability of this valve is to output error
reports. Setting this property allows to customize the look of the
- error pages which will be generated by Tomcat. This class must
- implement the
+ error pages which will be generated by Tomcat. This class must
+ implement the
<code>org.apache.catalina.Valve</code> interface. If none is specified,
- the value <code>org.apache.catalina.valves.ErrorReportValve</code>
+ the value <code>org.apache.catalina.valves.ErrorReportValve</code>
will be used by default.</p>
</attribute>
<attribute name="unpackWARs" required="false">
<p>Set to <code>true</code> if you want web applications that are
- deployed into this virtual host from a Web Application Archive (WAR)
- file to be unpacked into a disk directory structure, or
- <code>false</code> to run the application directly from a WAR file.</p>
+ placed in the <code>appBase</code> directory as web application
+ archive (WAR) files to be unpacked into a corresponding disk directory
+ structure, <code>false</code> to run such web applications directly
+ from a WAR file. See
+ <a href="#Automatic Application Deployment">Automatic Application
+ Deployment</a> for more information.</p>
</attribute>
</attributes>
@@ -215,6 +220,13 @@
This behavior is enabled by setting the <code>autoDeploy</code> attribute
to <code>true</code> (which is the default value):</p>
<ul>
+ <li>Any XML file in this directory is assumed to contain a
+ <a href="context.html">Context</a> element (and its associated
+ subelements) for a single web application. The <code>docBase</code>
+ attribute of this <code><Context></code> element will typically
+ be the absolute pathname to a web applicationd directory, or the
+ absolute pathname of a web application archive (WAR) file (which
+ will not be expanded).</li>
<li>Any web application archive file that does not have a corresponding
directory of the same name (without the ".war" extension) will be
automatically expanded, unless the <code>unpackWARs</code> property
@@ -232,19 +244,13 @@
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 ("").</li>
- <li>Any XML file in this directory is assumed to contain a
- <a href="context.html">Context</a> element (and its associated
- subelements) for a single web application. The <code>docBase</code>
- attribute of this <code><Context></code> element will typically
- be the absolute pathname to a web applicationd directory, or the
- absolute pathname of a web application archive (WAR) file (which
- will not be expanded).</li>
</ul>
<p>In addition to the automatic deployment that occurs at startup time,
you can also add new WAR files, directory, or XML configuration files
into the <code>appBase</code> directory at any time, and the corresponding
- applications will be automatically deployed.</p>
+ applications will be automatically deployed if the <code>autoDeploy</code>
+ property is set to <code>true</code>.</p>
</subsection>
--
To unsubscribe, e-mail: <ma...@jakarta.apache.org>
For additional commands, e-mail: <ma...@jakarta.apache.org>