larryi 02/02/23 19:47:16
Modified: src/doc serverxml.html
Log:
Document updates to AutoWebApp.
Revision Changes Path
1.21 +51 -2 jakarta-tomcat/src/doc/serverxml.html
Index: serverxml.html
===================================================================
RCS file: /home/cvs/jakarta-tomcat/src/doc/serverxml.html,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -r1.20 -r1.21
--- serverxml.html 8 Feb 2002 20:24:53 -0000 1.20
+++ serverxml.html 24 Feb 2002 03:47:16 -0000 1.21
@@ -4,7 +4,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
- <!-- $Id: serverxml.html,v 1.20 2002/02/08 20:24:53 larryi Exp $ -->
+ <!-- $Id: serverxml.html,v 1.21 2002/02/24 03:47:16 larryi Exp $ -->
<!-- Copyright 1999-2001 Apache Software Foundation -->
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" >
<link rel="stylesheet" href="style.css">
@@ -864,15 +864,57 @@
</tr>
<tr valign="top">
<td>host</td>
- <td>Virtual host into which each application will be deployed.</td>
+ <td>Virtual host into which each application will be deployed.<br>
+ <b>Note:</b> If this attribute is specified in <code>server.xml</code>,
+ the handling for <code>hostChar</code> and <code>hostDotChar</code> is
+ disabled.</td>
<td>DEFAULT</td>
</tr>
<tr valign="top">
+ <td>hostChar<br><b>[Tomcat 3.3.1]</td>
+ <td>Character used to designate the end of the host portion of the
+ directory name. For example, a directory named "mydomain@myapp"
+ would deploy to virtual host "mydomain" as the "/myapp"
+ context. Deriving a host name from the directory name is disabled if
+ the <code>host</code> attribute is specified in <code>server.xml</code>.
+ Also see the <code>hostDotChar</code> attribute for including periods in
+ the host name.<br>
+ <b>Note:</b> This attribute was implemented, but not configurable in
+ Tomcat 3.3. However, a bug in Tomcat 3.3 makes this feature unusable. The
+ '@' character is incorrectly included in the context name. This bug has
+ been corrected in Tomcat 3.3.1.</td>
+ <td>@</td>
+ </tr>
+ <tr valign="top">
+ <td>hostDotChar<br><b>[Tomcat 3.3.1]</td>
+ <td>Character used as a substitute for periods in the host portion of the
+ directory name. For example, a directory named
+ "www_mydomain_com@myapp" would deploy to virtual host
+ "www.mydomain.com" as the "/myapp" context. Also see
+ the <code>hostChar</code> attribute for designating the end of the host
+ name.<br>
+ <b>Note:</b> This attribute was implemented, but not configurable in
+ Tomcat 3.3. However, a bug in the handing for <code>hostChar</code> in
+ Tomcat 3.3 makes this feature unusable. It is fully funtional in
+ Tomcat 3.3.1.</td>
+ <td>_</td>
+ </tr>
+ <tr valign="top">
<td>ignoreDot</td>
<td>Ignore dirs starting with '.'</td>
<td>true</td>
</tr>
<tr valign="top">
+ <td>pathSlashChar<br><b>[Tomcat 3.3.1]</td>
+ <td>Character used as a substitute for slashes in the context path portion
+ of the directory name. For example, a directory named
+ "my_app" would deploy to the default host as the
+ "/my/app" context.<br>
+ <b>Note:</b> This attribute was implemented, but not configurable in
+ Tomcat 3.3.</td>
+ <td>_</td>
+ </tr>
+ <tr valign="top">
<td>prefix<br><b>[Tomcat 3.3.1]</b></td>
<td>Prefix to add to the context path for each deployed web application.
The context path will consist of the prefix followed subdirectory name.</td>
@@ -888,11 +930,18 @@
</tr>
</table>
+<p><b>Note:</b> The special directory name handling controlled by
+<code>hostChar</code>, <code>hostDotChar</code>, and <code>pathSlashChar</code>
+is always enabled. If you wish to include '_' characters in a web application
+directory name, disable the feature by redefining the <code>pathSlashChar</code>
+to an empty string.</p>
+
<h4>Example(s)</h4>
<pre>
<AutoWebApp dir="webapps" host="DEFAULT" />
<AutoWebApp dir="myhost" host="myhost.com" />
+ <AutoWebApp dir="webapps" pathSlashChar="" />
</pre>
<hr size="5">
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
