--- ajp.xml	Fri Oct  8 00:18:57 2004
+++ ajp.xml.new	Fri Oct  8 00:13:49 2004
@@ -9,6 +9,7 @@
   <properties>
     <author email="remm@apache.org">Remy Maucherat</author>
     <author email="yoavs@apache.org">Yoav Shapira</author>
+    <author email="arjaquith@mindspring.com">Andrew R. Jaquith</author>
     <title>The AJP Connector</title>
   </properties>
 
@@ -29,6 +30,13 @@
   the <code>jvmRoute</code> attribute of the 
   <a href="engine.html">Engine</a>.</p>
 
+  <p>For security reasons, Tomcat's default server configuration 
+  (in <code>server.xml</code> and <code>server-minimal.xml</code>)
+  specifies that all Connectors listen on the loopback interface,
+  and <strong>not</strong> on external interfaces. This
+  is a good, safe choice for testing, or in situations where Tomcat
+  is co-located on the same machine as the web server.</p>
+
 </section>
 
 
@@ -45,7 +53,9 @@
       <p>For servers with more than one IP address, this attribute
       specifies which address will be used for listening on the specified
       port.  By default, this port will be used on all IP addresses
-      associated with the server.</p>
+      associated with the server. A value of <code>127.0.0.1</code>
+      indicates that the Connector will only listen on the loopback
+      interface.</p>
     </attribute>
 
     <attribute name="allowTrace" required="false">
@@ -67,6 +77,23 @@
       the container FORM URL parameter parsing. The feature can be disbled by 
       setting this attribute to a value inferior or equal to 0. 
       If not specified, this attribute is set to 2097152 (2 megabytes).</p>
+    </attribute>
+
+    <attribute name="minProcessors" required="false">
+      <p>The minimum number of processors to start at initialization time.
+      If not specified, this atttribute is set to 5.</p>
+    </attribute>
+
+    <attribute name="maxProcessors" required="false">
+      <p>The maximum number of processors allowed. This should be
+      set to a value that is greater than or equal to the maximum number
+      of concurrent connections the remote web server can open to Tomcat 
+      simultaneously. For example, if the web server is Apache 1.x or 2.x
+      Tomcat's <code>maxProcessors</code> should be set to the 
+      value of Apache's <code>maxClients</code> directive.</p>
+      <p>A <code>maxProcessors</code> value of zero (0) signifies that 
+      the number of processors is unlimited. If not specified, this
+      atttribute defaults to 20.</p>
     </attribute>
 
     <attribute name="redirectPort" required="false">
Index: ajp.xml
===================================================================
RCS file: /home/cvspublic/jakarta-tomcat-catalina/webapps/docs/config/ajp.xml,v
retrieving revision 1.4.2.1
diff -u -r1.4.2.1 ajp.xml
--- ajp.xml	21 Aug 2004 15:50:12 -0000	1.4.2.1
+++ ajp.xml	16 Oct 2004 00:14:56 -0000
@@ -9,6 +9,7 @@
   <properties>
     <author email="remm@apache.org">Remy Maucherat</author>
     <author email="yoavs@apache.org">Yoav Shapira</author>
+    <author email="arjaquith@mindspring.com">Andrew R. Jaquith</author>
     <title>The AJP Connector</title>
   </properties>
 
@@ -60,6 +61,23 @@
       to <code>false</code> to skip the DNS lookup and return the IP
       address in String form instead (thereby improving performance).
       By default, DNS lookups are enabled.</p>
+    </attribute>
+
+    <attribute name="minProcessors" required="false">
+      <p>The minimum number of processors to start at initialization time.
+      If not specified, this atttribute is set to 5.</p>
+    </attribute>
+
+    <attribute name="maxProcessors" required="false">
+      <p>The maximum number of processors allowed. This should be
+      set to a value that is greater than or equal to the maximum number
+      of concurrent connections the remote web server can open to Tomcat 
+      simultaneously. For example, if the web server is Apache 1.x or 2.x
+      Tomcat's <code>maxProcessors</code> should be set to the 
+      value of Apache's <code>maxClients</code> directive.</p>
+      <p>A <code>maxProcessors</code> value of zero (0) signifies that 
+      the number of processors is unlimited. If not specified, this
+      atttribute defaults to 20.</p>
     </attribute>
 
     <attribute name="maxPostSize" required="false">