]> granicus.if.org Git - apache/commitdiff
Remove the nroff httpd man page and put in an xml one in the manual.
authorJoshua Slive <slive@apache.org>
Thu, 14 Nov 2002 16:24:53 +0000 (16:24 +0000)
committerJoshua Slive <slive@apache.org>
Thu, 14 Nov 2002 16:24:53 +0000 (16:24 +0000)
At the same time, update with some new args.  More review of
this would be good.

Reviewed by: Astrid Kessler, Erik Abele, Andr� Malo, Rich Bowen

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

docs/man/httpd.8 [deleted file]
docs/manual/programs/httpd.html [deleted file]
docs/manual/programs/httpd.html.en [new file with mode: 0644]
docs/manual/programs/httpd.xml [new file with mode: 0644]

diff --git a/docs/man/httpd.8 b/docs/man/httpd.8
deleted file mode 100644 (file)
index a13162d..0000000
+++ /dev/null
@@ -1,179 +0,0 @@
-.TH httpd 8 "February 1997"
-.\" The Apache Software License, Version 1.1
-.\"
-.\" Copyright (c) 2000-2002 The Apache Software Foundation.  All rights
-.\" reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\"
-.\" 3. The end-user documentation included with the redistribution,
-.\"    if any, must include the following acknowledgment:
-.\"       "This product includes software developed by the
-.\"        Apache Software Foundation (http://www.apache.org/)."
-.\"    Alternately, this acknowledgment may appear in the software itself,
-.\"    if and wherever such third-party acknowledgments normally appear.
-.\"
-.\" 4. The names "Apache" and "Apache Software Foundation" must
-.\"    not be used to endorse or promote products derived from this
-.\"    software without prior written permission. For written
-.\"    permission, please contact apache@apache.org.
-.\"
-.\" 5. Products derived from this software may not be called "Apache",
-.\"    nor may "Apache" appear in their name, without prior written
-.\"    permission of the Apache Software Foundation.
-.\"
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
-.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-.\" DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
-.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" This software consists of voluntary contributions made by many
-.\" individuals on behalf of the Apache Software Foundation.  For more
-.\" information on the Apache Software Foundation, please see
-.\" <http://www.apache.org/>.
-.\"
-.SH NAME
-httpd \- Apache hypertext transfer protocol server
-.SH SYNOPSIS
-.B httpd 
-[
-.BI \-d " serverroot"
-] [
-.BI \-f " config"
-] [
-.BI \-C " directive"
-] [
-.BI \-c " directive"
-] [
-.BI \-D " parameter"
-]
-
-.B httpd 
-[
-.B \-h
-] 
-[
-.B \-l
-] 
-[
-.B \-L
-] 
-[
-.B \-v
-] 
-[
-.B \-V
-] 
-[
-.B \-t
-] 
-[
-.B \-X
-]
-
-.SH DESCRIPTION
-.B httpd
-is the Apache HyperText Transfer Protocol (HTTP) server program. It is
-designed to be run as a standalone daemon process. When used like this
-it will create a pool of child processes to handle requests. To stop
-it, send a TERM signal to the initial (parent) process. The PID of
-this process is written to a file as given in the configuration file.
-.PP
-This manual page only lists the command line arguments. For details
-of the directives necessary to configure 
-.B httpd
-see the Apache manual,
-which is part of the Apache distribution or can be found at
-http://httpd.apache.org/. Paths in this manual may not reflect those
-compiled into 
-.B httpd.
-.SH OPTIONS
-.TP 12
-.BI \-d " serverroot"
-Set the initial value for the ServerRoot directive to \fIserverroot\fP. This
-can be overridden by the ServerRoot command in the configuration file. The
-default is \fB/usr/local/apache2\fP.
-.TP
-.BI \-f " config"
-Execute the commands in the file \fIconfig\fP on startup. If \fIconfig\fP
-does not begin with a /, then it is taken to be a path relative to
-the ServerRoot. The default is \fBconf/httpd.conf\fP.
-.TP
-.BI \-C " directive"
-Process the configuration \fIdirective\fP before reading config files.
-.TP
-.BI \-c " directive"
-Process the configuration \fIdirective\fP after reading config files.
-.TP
-.BI \-D " parameter"
-Sets a configuration \fIparameter\fP which can be used with
-<IfDefine>...</IfDefine> sections in the configuration files
-to conditionally skip or process commands.
-.TP
-.B \-h
-Output a short summary of available command line options.
-.TP
-.B \-l
-Output a list of modules compiled into the server.
-.TP
-.B \-L
-Output a list of directives together with expected arguments and
-places where the directive is valid.
-.TP
-.B \-S
-Show the settings as parsed from the config file (currently only shows the
-virtualhost settings).
-.TP
-.B \-t
-Run syntax tests for configuration files only. The program immediately exits
-after these syntax parsing with either a return code of 0 (Syntax OK) or
-return code not equal to 0 (Syntax Error).  If 
-.BI \-D " DUMP_VHOSTS"
-is also set, details of the virtual host configuration will be printed.
-.TP
-.B \-v
-Print the version of 
-.B httpd
-, and then exit.
-.TP
-.B \-V
-Print the version and build parameters of 
-.B httpd
-, and then exit.
-.TP
-.B \-X
-Run
-.B httpd
-in debug mode.  Only one worker will be started and the server will not detach
-from the console.
-.SH FILES
-.PD 0
-.B /usr/local/apache2/conf/httpd.conf
-.br
-.B /usr/local/apache2/conf/mime.types
-.br
-.B /usr/local/apache2/conf/magic
-.br
-.B /usr/local/apache2/logs/error_log
-.br
-.B /usr/local/apache2/logs/access_log
-.br
-.B /usr/local/apache2/logs/httpd.pid
diff --git a/docs/manual/programs/httpd.html b/docs/manual/programs/httpd.html
deleted file mode 100644 (file)
index 6ecd536..0000000
+++ /dev/null
@@ -1,102 +0,0 @@
-
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head><title>Manual Page: httpd  - Apache HTTP Server</title></head>
-<body bgcolor="#ffffff" text="#000000" link="#0000ff"
-vlink="#000080" alink="#ff0000">
-<!--#include virtual="header.html" -->
-<h1 align="center">Manual Page: httpd</h1>
-<!-- This document was autogenerated from the man page -->
-<pre>
-<strong>NAME</strong>
-     httpd - Apache hypertext transfer protocol server
-
-<strong>SYNOPSIS</strong>
-     <strong>httpd </strong>[ -<strong>d </strong><em>serverroot </em>] [ -<strong>f </strong><em>config </em>] [ -<strong>C </strong><em>directive </em>] [  -<strong>c</strong>
-     <em>directive </em>] [ -<strong>D </strong><em>parameter </em>]
-
-     <strong>httpd </strong>[ -<strong>h </strong>] [ -<strong>l </strong>] [ -<strong>L </strong>] [ -<strong>v </strong>] [ -<strong>V </strong>] [ -<strong>t </strong>] [ -<strong>X </strong>]
-
-<strong>DESCRIPTION</strong>
-     <strong>httpd </strong>is  the  Apache  HyperText  Transfer  Protocol  (HTTP)
-     server  program.  It  is  designed to be run as a standalone
-     daemon process. When used like this it will create a pool of
-     child  processes to handle requests. To stop it, send a TERM
-     signal to the initial (parent) process. The PID of this pro-
-     cess  is  written  to  a  file as given in the configuration
-     file.
-
-     This manual page only lists the command line arguments.  For
-     details  of  the directives necessary to configure <strong>httpd </strong>see
-     the Apache manual, which is part of the Apache  distribution
-     or  can  be found at http://httpd.apache.org/. Paths in this
-     manual may not reflect those compiled into <strong>httpd.</strong>
-
-<strong>OPTIONS</strong>
-     -<strong>d </strong><em>serverroot</em>
-                 Set the initial value for the ServerRoot  direc-
-                 tive  to  <em>serverroot</em>.  This can be overridden by
-                 the  ServerRoot  command  in  the  configuration
-                 file. The default is <strong>/usr/local/apache2</strong>.
-
-     -<strong>f </strong><em>config   </em>Execute the  commands  in  the  file  <em>config  </em>on
-                 startup. If <em>config </em>does not begin with a /, then
-                 it is taken to be a path relative to the Server-
-                 Root. The default is <strong>conf/httpd.conf</strong>.
-
-     -<strong>C </strong><em>directive</em>
-                 Process the configuration <em>directive </em>before read-
-                 ing config files.
-
-     -<strong>c </strong><em>directive</em>
-                 Process the configuration <em>directive </em>after  read-
-                 ing config files.
-
-     -<strong>D </strong><em>parameter</em>
-                 Sets a configuration <em>parameter </em>which can be used
-                 with  &lt;IfDefine&gt;...&lt;/IfDefine&gt;  sections  in the
-                 configuration files  to  conditionally  skip  or
-                 process commands.
-
-     -<strong>h          </strong>Output a short summary of available command line
-                 options.
-
-     -<strong>l          </strong>Output a  list  of  modules  compiled  into  the
-                 server.
-
-     -<strong>L          </strong>Output  a  list  of  directives  together   with
-                 expected  arguments  and places where the direc-
-                 tive is valid.
-
-     -<strong>S          </strong>Show the settings as parsed from the config file
-                 (currently only shows the virtualhost settings).
-
-     -<strong>t          </strong>Run syntax tests for configuration  files  only.
-                 The program immediately exits after these syntax
-                 parsing with either a return code of  0  (Syntax
-                 OK)  or  return  code  not  equal  to  0 (Syntax
-                 Error).  If -<strong>D </strong><em>DUMP</em>_<em>VHOSTS </em>is also set,  details
-                 of   the  virtual  host  configuration  will  be
-                 printed.
-
-     -<strong>v          </strong>Print the version of <strong>httpd </strong>, and then exit.
-
-     -<strong>V          </strong>Print the version and build parameters of  <strong>httpd</strong>
-                 , and then exit.
-
-     -<strong>X          </strong>Run <strong>httpd </strong>in debug mode.  Only one  worker  will
-                 be  started  and the server will not detach from
-                 the console.
-
-<strong>FILES</strong>
-     <strong>/usr/local/apache2/conf/httpd.conf</strong>
-     <strong>/usr/local/apache2/conf/mime.types</strong>
-     <strong>/usr/local/apache2/conf/magic</strong>
-     <strong>/usr/local/apache2/logs/error_log</strong>
-     <strong>/usr/local/apache2/logs/access_log</strong>
-     <strong>/usr/local/apache2/logs/httpd.pid</strong>
-
-</pre>
-<!--#include virtual="footer.html" -->
-</body></html>
diff --git a/docs/manual/programs/httpd.html.en b/docs/manual/programs/httpd.html.en
new file mode 100644 (file)
index 0000000..4773065
--- /dev/null
@@ -0,0 +1,157 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      --><title>httpd - Apache Hypertext Transfer Protocol Server - Apache HTTP Server</title><link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /><link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /><link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link href="../images/favicon.ico" rel="shortcut icon" /></head><body id="manual-page"><div id="page-header"><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p><p class="apache">Apache HTTP Server Version 2.0</p><img alt="" src="../images/feather.gif" /></div><div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div><div id="path"><a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.0</a> &gt; <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>httpd - Apache Hypertext Transfer Protocol Server</h1>
+     <p><code>httpd</code> is the Apache HyperText Transfer Protocol
+     (HTTP) server program.  It is designed to be run as a standalone
+     daemon process. When used like this it will create a pool of
+     child processes or threads to handle requests.</p>
+
+     <p>In general, <code>httpd</code> should not be invoked directly,
+     but rather should be invoked via <a href="apachectl.html">apachectl</a> on unix systems or as an NT
+     service under win32.</p>
+</div><div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li><li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li></ul><h3>See also</h3><ul class="seealso"><li><a href="../invoking.html">Starting Apache</a></li><li><a href="../stopping.html">Stopping Apache</a></li><li><a href="../configuring.html">Configuration Files</a></li><li><a href="../platform/">Platform Docs</a></li><li><a href="apachectl.html">apachectl</a></li></ul></div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="synopsis" id="synopsis">Synopsis</a></h2>
+
+     <p><code><strong>httpd </strong>[ -<strong>d </strong><var>serverroot
+     </var>] [ -<strong>f </strong><var>config </var>] [ -<strong>C
+     </strong> <var>directive </var>] [ -<strong>c </strong>
+     <var>directive</var>] [ -<strong>D </strong> <var>parameter
+     </var>] [ -<strong>e </strong> <var>level</var> ] [ -<strong>E
+     </strong> <var>file</var> ] [ <strong>-k </strong>
+     <code>start|restart|graceful|stop</code> ] [ -<strong>R </strong>
+     <var>directory</var> ] [ -<strong>h </strong>] [ -<strong>l
+     </strong>] [ -<strong>L </strong>] [-<strong>S</strong>] [
+     -<strong>t </strong>] [ -<strong>v </strong>] [ -<strong>V
+     </strong>] [ -<strong>X </strong>]</code></p>
+
+     <p>On <a href="../platform/windows.html">Win32 systems</a>, the
+     following additional arguments are available:</p>
+
+     <p><code><strong>httpd </strong> [ -<strong>k </strong>
+     <code>install|config|uninstall</code> ] [ -<strong>n </strong>
+     <var>name</var> ] [ -<strong>w</strong> ]</code></p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div><div class="section"><h2><a name="options" id="options">Options</a></h2>
+
+<dl>
+<dt><code>-d <var>serverroot</var></code></dt>
+
+<dd>Set the initial value for the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> directive to
+<var>serverroot</var>.  This can be overridden by the ServerRoot
+directive in the configuration file. The default is
+<code>/usr/local/apache2</code>.</dd>
+
+<dt><code>-f <var>config</var></code></dt>
+
+<dd>Uses the directives in the file <var>config</var> on startup. If
+<var>config</var> does not begin with a /, then it is taken to be a
+path relative to the <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code>. The default is
+<code>conf/httpd.conf</code>.</dd>
+
+<dt><code>-k <code>start|restart|graceful|stop</code></code></dt>
+
+<dd>Signals <code>httpd</code> to start, restart, or stop.  See <a href="../stopping.html">Stopping Apache</a> for more information.</dd>
+
+<dt><code>-C <var>directive</var></code></dt>
+
+<dd>Process the configuration <var>directive</var> before reading
+config files.</dd>
+
+<dt><code>-c <var>directive</var></code></dt>
+
+<dd>Process the configuration <var>directive</var> after reading config
+files.</dd>
+
+
+<dt><code>-D <var>parameter</var></code></dt>
+
+<dd>Sets a configuration <var>parameter </var>which can be used with
+<code class="directive"><a href="../mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> sections
+in the configuration files to conditionally skip or process
+commands at server startup and restart.</dd>
+
+<dt><code>-e <var>level</var></code></dt>
+
+<dd>Sets the <code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> to
+<var>level</var> during server startup.  This is useful for
+temporarily increasing the verbosity of the error messages to find
+problems during startup.</dd>
+
+<dt><code>-E <var>file</var></code></dt>
+
+<dd>Send error messages during server startup to <var>file</var>.</dd>
+
+<dt><code>-R <var>directory</var></code></dt>
+
+<dd>When the server is compiled using the <code>SHARED_CORE</code>
+rule, this specifies the <var>directory</var> for the shared
+object files.</dd>
+
+<dt><code>-h</code></dt>
+
+<dd>Output a short summary of available command line options.</dd>
+
+<dt><code>-l</code></dt>
+
+<dd>Output a list of modules compiled into the server.  This will
+<strong>not</strong> list dynamically loaded modules included using
+the <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> directive.</dd>
+
+<dt><code>-L</code></dt>
+
+<dd>Output a list of directives together with expected arguments and
+places where the directive is valid.</dd>
+
+<dt><code>-S</code></dt>
+
+<dd>Show the settings as parsed from the config file (currently only
+shows the virtualhost settings).</dd>
+
+<dt><code>-t</code></dt>
+
+<dd>Run syntax tests for configuration files only.  The program
+immediately exits after these syntax parsing with either a return code
+of 0 (Syntax OK) or return code not equal to 0 (Syntax Error).  If -D
+<var>DUMP</var>_<var>VHOSTS </var>is also set, details of the virtual host
+configuration will be printed.</dd>
+
+<dt><code>-v</code></dt>
+
+<dd>Print the version of <code>httpd</code>, and then exit.</dd>
+
+<dt><code>-V</code></dt>
+
+<dd>Print the version and build parameters of <code>httpd</code>, and
+then exit.</dd>
+
+<dt><code>-X</code></dt>
+
+<dd>Run httpd in debug mode.  Only one worker will be started and the
+server will not detach from the console.</dd>
+
+</dl>
+
+<p>The following arguments are available only on the <a href="../platform/windows.html">win32 platform</a>:</p>
+
+<dl>
+
+<dt><code>-k <code>install|config|uninstall</code></code></dt>
+
+<dd>Install Apache as a Windows NT service; change startup options for
+the Apache service; and uninstall the Apache service.</dd>
+
+<dt><code>-n <var>name</var></code></dt>
+
+<dd>The <var>name</var> of the Apache service to signal.</dd>
+
+<dt><code>-w</code></dt>
+
+<dd>Hold the console window open on error so that the error message can 
+be read.</dd>
+
+</dl>
+
+</div></div><div id="footer"><p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p><p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div></body></html>
\ No newline at end of file
diff --git a/docs/manual/programs/httpd.xml b/docs/manual/programs/httpd.xml
new file mode 100644 (file)
index 0000000..13d0fc8
--- /dev/null
@@ -0,0 +1,177 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<manualpage>
+<relativepath href=".."/>
+<parentdocument href="./">Programs</parentdocument>
+
+  <title>httpd - Apache Hypertext Transfer Protocol Server</title>
+
+<summary>
+     <p><code>httpd</code> is the Apache HyperText Transfer Protocol
+     (HTTP) server program.  It is designed to be run as a standalone
+     daemon process. When used like this it will create a pool of
+     child processes or threads to handle requests.</p>
+
+     <p>In general, <code>httpd</code> should not be invoked directly,
+     but rather should be invoked via <a
+     href="apachectl.html">apachectl</a> on unix systems or as an NT
+     service under win32.</p>
+</summary>
+
+<seealso><a href="../invoking.html">Starting Apache</a></seealso>
+<seealso><a href="../stopping.html">Stopping Apache</a></seealso>
+<seealso><a href="../configuring.html">Configuration Files</a></seealso>
+<seealso><a href="../platform/">Platform Docs</a></seealso>
+<seealso><a href="apachectl.html">apachectl</a></seealso>
+
+<section id="synopsis"><title>Synopsis</title>
+
+     <p><code><strong>httpd </strong>[ -<strong>d </strong><var>serverroot
+     </var>] [ -<strong>f </strong><var>config </var>] [ -<strong>C
+     </strong> <var>directive </var>] [ -<strong>c </strong>
+     <var>directive</var>] [ -<strong>D </strong> <var>parameter
+     </var>] [ -<strong>e </strong> <var>level</var> ] [ -<strong>E
+     </strong> <var>file</var> ] [ <strong>-k </strong>
+     <code>start|restart|graceful|stop</code> ] [ -<strong>R </strong>
+     <var>directory</var> ] [ -<strong>h </strong>] [ -<strong>l
+     </strong>] [ -<strong>L </strong>] [-<strong>S</strong>] [
+     -<strong>t </strong>] [ -<strong>v </strong>] [ -<strong>V
+     </strong>] [ -<strong>X </strong>]</code></p>
+
+     <p>On <a href="../platform/windows.html">Win32 systems</a>, the
+     following additional arguments are available:</p>
+
+     <p><code><strong>httpd </strong> [ -<strong>k </strong>
+     <code>install|config|uninstall</code> ] [ -<strong>n </strong>
+     <var>name</var> ] [ -<strong>w</strong> ]</code></p>
+
+</section>
+
+<section id="options"><title>Options</title>
+
+<dl>
+<dt><code>-d <var>serverroot</var></code></dt>
+
+<dd>Set the initial value for the <directive
+module="core">ServerRoot</directive> directive to
+<var>serverroot</var>.  This can be overridden by the ServerRoot
+directive in the configuration file. The default is
+<code>/usr/local/apache2</code>.</dd>
+
+<dt><code>-f <var>config</var></code></dt>
+
+<dd>Uses the directives in the file <var>config</var> on startup. If
+<var>config</var> does not begin with a /, then it is taken to be a
+path relative to the <directive
+module="core">ServerRoot</directive>. The default is
+<code>conf/httpd.conf</code>.</dd>
+
+<dt><code>-k <code>start|restart|graceful|stop</code></code></dt>
+
+<dd>Signals <code>httpd</code> to start, restart, or stop.  See <a
+href="../stopping.html">Stopping Apache</a> for more information.</dd>
+
+<dt><code>-C <var>directive</var></code></dt>
+
+<dd>Process the configuration <var>directive</var> before reading
+config files.</dd>
+
+<dt><code>-c <var>directive</var></code></dt>
+
+<dd>Process the configuration <var>directive</var> after reading config
+files.</dd>
+
+
+<dt><code>-D <var>parameter</var></code></dt>
+
+<dd>Sets a configuration <var>parameter </var>which can be used with
+<directive type="section" module="core">IfDefine</directive> sections
+in the configuration files to conditionally skip or process
+commands at server startup and restart.</dd>
+
+<dt><code>-e <var>level</var></code></dt>
+
+<dd>Sets the <directive module="core">LogLevel</directive> to
+<var>level</var> during server startup.  This is useful for
+temporarily increasing the verbosity of the error messages to find
+problems during startup.</dd>
+
+<dt><code>-E <var>file</var></code></dt>
+
+<dd>Send error messages during server startup to <var>file</var>.</dd>
+
+<dt><code>-R <var>directory</var></code></dt>
+
+<dd>When the server is compiled using the <code>SHARED_CORE</code>
+rule, this specifies the <var>directory</var> for the shared
+object files.</dd>
+
+<dt><code>-h</code></dt>
+
+<dd>Output a short summary of available command line options.</dd>
+
+<dt><code>-l</code></dt>
+
+<dd>Output a list of modules compiled into the server.  This will
+<strong>not</strong> list dynamically loaded modules included using
+the <directive module="mod_so">LoadModule</directive> directive.</dd>
+
+<dt><code>-L</code></dt>
+
+<dd>Output a list of directives together with expected arguments and
+places where the directive is valid.</dd>
+
+<dt><code>-S</code></dt>
+
+<dd>Show the settings as parsed from the config file (currently only
+shows the virtualhost settings).</dd>
+
+<dt><code>-t</code></dt>
+
+<dd>Run syntax tests for configuration files only.  The program
+immediately exits after these syntax parsing with either a return code
+of 0 (Syntax OK) or return code not equal to 0 (Syntax Error).  If -D
+<var>DUMP</var>_<var>VHOSTS </var>is also set, details of the virtual host
+configuration will be printed.</dd>
+
+<dt><code>-v</code></dt>
+
+<dd>Print the version of <code>httpd</code>, and then exit.</dd>
+
+<dt><code>-V</code></dt>
+
+<dd>Print the version and build parameters of <code>httpd</code>, and
+then exit.</dd>
+
+<dt><code>-X</code></dt>
+
+<dd>Run httpd in debug mode.  Only one worker will be started and the
+server will not detach from the console.</dd>
+
+</dl>
+
+<p>The following arguments are available only on the <a
+href="../platform/windows.html">win32 platform</a>:</p>
+
+<dl>
+
+<dt><code>-k <code>install|config|uninstall</code></code></dt>
+
+<dd>Install Apache as a Windows NT service; change startup options for
+the Apache service; and uninstall the Apache service.</dd>
+
+<dt><code>-n <var>name</var></code></dt>
+
+<dd>The <var>name</var> of the Apache service to signal.</dd>
+
+<dt><code>-w</code></dt>
+
+<dd>Hold the console window open on error so that the error message can 
+be read.</dd>
+
+</dl>
+
+</section>
+
+</manualpage>