Update the docs regarding the shutdown port number. It is a followup to r938430.

As Steven Schlansker noted on the users list, disabling the port affects un*x systems,
as kill -9 is not a clean shutdown.

git-svn-id: https://svn.apache.org/repos/asf/tomcat/trunk@1086036 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/webapps/docs/config/server.xml b/webapps/docs/config/server.xml
index 42e979a..aa886ae 100644 (file)
--- a/webapps/docs/config/server.xml
+++ b/webapps/docs/config/server.xml
@@ -66,11 +66,13 @@
 
     <attribute name="port" required="true">
       <p>The TCP/IP port number on which this server waits for a shutdown
-      command. Set to <code>-1</code> to disable the shutdown port. Note:
-      Disabling the shutdown port will prevent shutdown.bat and catalina.bat
-      from stopping the Tomcat process on Windows operating systems. Operating
-      systems that use the *.sh scripts will not be affected by disabling the
-      shutdown port.</p>
+      command. Set to <code>-1</code> to disable the shutdown port.</p>
+      <p>Note: Disabling the shutdown port works well when Tomcat is started
+      using <a href="http://commons.apache.org/daemon/">Apache Commons Daemon</a>
+      (running as a service on Windows or with jsvc on un*xes). It cannot be
+      used when running Tomcat with the standard shell scripts though, as it
+      will prevent shutdown.bat|.sh and catalina.bat|.sh from stopping it
+      gracefully.</p>
     </attribute>
 
     <attribute name="shutdown" required="true">