Document the -k command line argument. This is based on a previous

patch to add this documentation from bhyde@pobox.com (16 Jun 1998).

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

diff --git a/docs/manual/platform/windows.html b/docs/manual/platform/windows.html
index b4879e95ec4ce221394ed7e64e30cfa0d223ae7e..2eb65247b73a3d45e3adc2c407b608098b7ec40f 100644 (file)
--- a/docs/manual/platform/windows.html
+++ b/docs/manual/platform/windows.html
@@ -17,7 +17,7 @@
 <H1 ALIGN="CENTER">Using Apache With Microsoft Windows</H1>
 
 <P>This document explains how to install, configure and run
-   Apache 1.3 under Microsoft Windows. Please note that at
+   Apache 1.3b6 and later under Microsoft Windows. Please note that at
    this time, Windows support is entirely experimental, and is
    recommended only for experienced users. The Apache Group does not
    guarantee that this software will work as documented, or even at
@@ -47,6 +47,7 @@ to help with development, or to track down bugs), see the section on
   <LI><A HREF="#run">Running Apache for Windows</A>
   <LI><A HREF="#use">Using Apache for Windows</A>
   <LI><A HREF="#cmdline">Running Apache for Windows from the Command Line</A>
+  <LI><A HREF="#signal">Signalling Apache when running</A>
   <LI><A HREF="#comp">Compiling Apache for Windows</A>
 </UL>
 
@@ -183,8 +184,8 @@ with
 To run Apache from a console window, select the "Apache Server" option
 from the Start menu. This will open a console window and start Apache
 running inside it. The window will remain active until you stop
-Apache. To stop Apache running, press Control-C within the console
-window.
+Apache. To stop Apache running, see <A HREF="#signal>Signalling Apache
+when Running</SAMP>.
 
 <P>
 
@@ -356,6 +357,35 @@ and to remove the Apache service, use
 </PRE>
 
 
+<H2><A NAME="signal">Signalling Apache when running</A></H2>
+
+On Windows 95 Apache runs as a console application. You can tell a
+running Apache to stop by opening another console window and running
+
+<PRE>
+    apache -k shutdown
+</PRE>
+
+This should be used instead of pressing Control-C in the running
+Apache console window, because it lets Apache end any current
+transactions and cleanup gracefully.
+
+<P>
+
+You can also tell Apache to restart. This makes it re-read the
+configuration files. Any transactions in progress are allowed to
+complete without interruption. To restart Apache, run
+
+<PRE>
+    apache -k restart
+</PRE>
+
+Note for people familiar with the Unix version of Apache: these
+commands provide a Windows equivalent to <CODE>kill -TERM
+<i>pid</i></CODE> and <CODE>kill -USR1 <i>pid</i></CODE>. The command
+line option used, <CODE>-k</CODE>, was chosen as a reminder of the
+"kill" command used on Unix.
+
 <H2><A NAME="comp">Compiling Apache for Windows</A></H2>
 
 <P>Compiling Apache requires Microsoft Visual C++ 5.0 to be properly