From aa6e3666a200417ce522a0ad0d2b0c7c3de1f804 Mon Sep 17 00:00:00 2001
From: kkolinko <kkolinko@13f79535-47bb-0310-9956-ffa450edef68>
Date: Sun, 27 Mar 2011 20:58:13 +0000
Subject: [PATCH] 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
---
 webapps/docs/config/server.xml | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/webapps/docs/config/server.xml b/webapps/docs/config/server.xml
index 42e979afe..aa886ae17 100644
--- 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">
-- 
2.11.0