openbsd-ports/www/apache-httpd/patches/patch-docs_man_apachectl_8

99 lines
7.3 KiB
Plaintext
Raw Normal View History

$OpenBSD: patch-docs_man_apachectl_8,v 1.2 2007/03/25 17:40:55 deanna Exp $
--- docs/man/apachectl.8.orig Tue Sep 20 10:54:17 2005
+++ docs/man/apachectl.8 Sun Mar 25 13:21:03 2007
@@ -19,56 +19,56 @@
.el .ne 3
.IP "\\$1" \\$2
..
-.TH "APACHECTL" 8 "2005-09-20" "Apache HTTP Server" "apachectl"
+.TH "APACHECTL2" 8 "2005-09-20" "Apache HTTP Server" "apachectl2"
.SH NAME
-apachectl \- Apache HTTP Server Control Interface
+apachectl2 \- Apache HTTP Server Control Interface
.SH "SYNOPSIS"
.PP
-When acting in pass-through mode, apachectl can take all the arguments available for the httpd binary\&.
+When acting in pass-through mode, apachectl2 can take all the arguments available for the httpd2 binary\&.
.PP
-\fBapachectl\fR [ \fIhttpd-argument\fR ]
+\fBapachectl2\fR [ \fIhttpd2-argument\fR ]
.PP
-When acting in SysV init mode, apachectl takes simple, one-word commands, defined below\&.
+When acting in SysV init mode, apachectl2 takes simple, one-word commands, defined below\&.
.PP
-\fBapachectl\fR \fIcommand\fR
+\fBapachectl2\fR \fIcommand\fR
.SH "SUMMARY"
.PP
-apachectl is a front end to the Apache HyperText Transfer Protocol (HTTP) server\&. It is designed to help the administrator control the functioning of the Apache httpd daemon\&.
+apachectl2 is a front end to the Apache HyperText Transfer Protocol (HTTP) server\&. It is designed to help the administrator control the functioning of the Apache httpd2 daemon\&.
.PP
-The apachectl script can operate in two modes\&. First, it can act as a simple front-end to the httpd command that simply sets any necessary environment variables and then invokes httpd, passing through any command line arguments\&. Second, apachectl can act as a SysV init script, taking simple one-word arguments like start, restart, and stop, and translating them into appropriate signals to httpd\&.
+The apachectl2 script can operate in two modes\&. First, it can act as a simple front-end to the httpd2 command that simply sets any necessary environment variables and then invokes httpd2, passing through any command line arguments\&. Second, apachectl2 can act as a SysV init script, taking simple one-word arguments like start, restart, and stop, and translating them into appropriate signals to httpd2\&.
.PP
-If your Apache installation uses non-standard paths, you will need to edit the apachectl script to set the appropriate paths to the httpd binary\&. You can also specify any necessary httpd command line arguments\&. See the comments in the script for details\&.
+If your Apache installation uses non-standard paths, you will need to edit the apachectl2 script to set the appropriate paths to the httpd2 binary\&. You can also specify any necessary httpd2 command line arguments\&. See the comments in the script for details\&.
.PP
-The apachectl script returns a 0 exit value on success, and >0 if an error occurs\&. For more details, view the comments in the script\&.
+The apachectl2 script returns a 0 exit value on success, and >0 if an error occurs\&. For more details, view the comments in the script\&.
.SH "OPTIONS"
.PP
-Only the SysV init-style options are defined here\&. Other arguments are defined on the httpd manual page\&.
+Only the SysV init-style options are defined here\&. Other arguments are defined on the httpd2 manual page\&.
.TP
start
-Start the Apache httpd daemon\&. Gives an error if it is already running\&. This is equivalent to apachectl -k start\&.
+Start the Apache httpd2 daemon\&. Gives an error if it is already running\&. This is equivalent to apachectl2 -k start\&.
.TP
stop
-Stops the Apache httpd daemon\&. This is equivalent to apachectl -k stop\&.
+Stops the Apache httpd2 daemon\&. This is equivalent to apachectl2 -k stop\&.
.TP
restart
-Restarts the Apache httpd daemon\&. If the daemon is not running, it is started\&. This command automatically checks the configuration files as in configtest before initiating the restart to make sure the daemon doesn't die\&. This is equivalent to apachectl -k restart\&.
+Restarts the Apache httpd2 daemon\&. If the daemon is not running, it is started\&. This command automatically checks the configuration files as in configtest before initiating the restart to make sure the daemon doesn't die\&. This is equivalent to apachectl2 -k restart\&.
.TP
fullstatus
Displays a full status report from mod_status\&. For this to work, you need to have mod_status enabled on your server and a text-based browser such as lynx available on your system\&. The URL used to access the status report can be set by editing the STATUSURL variable in the script\&.
@@ -77,13 +77,13 @@ status
Displays a brief status report\&. Similar to the fullstatus option, except that the list of requests currently being served is omitted\&.
.TP
graceful
-Gracefully restarts the Apache httpd daemon\&. If the daemon is not running, it is started\&. This differs from a normal restart in that currently open connections are not aborted\&. A side effect is that old log files will not be closed immediately\&. This means that if used in a log rotation script, a substantial delay may be necessary to ensure that the old log files are closed before processing them\&. This command automatically checks the configuration files as in configtest before initiating the restart to make sure Apache doesn't die\&. This is equivalent to apachectl -k graceful\&.
+Gracefully restarts the Apache httpd2 daemon\&. If the daemon is not running, it is started\&. This differs from a normal restart in that currently open connections are not aborted\&. A side effect is that old log files will not be closed immediately\&. This means that if used in a log rotation script, a substantial delay may be necessary to ensure that the old log files are closed before processing them\&. This command automatically checks the configuration files as in configtest before initiating the restart to make sure Apache doesn't die\&. This is equivalent to apachectl2 -k graceful\&.
.TP
graceful-stop
-Gracefully stops the Apache httpd daemon\&. This differs from a normal stop in that currently open connections are not aborted\&. A side effect is that old log files will not be closed immediately\&. This is equivalent to apachectl -k graceful-stop\&.
+Gracefully stops the Apache httpd2 daemon\&. This differs from a normal stop in that currently open connections are not aborted\&. A side effect is that old log files will not be closed immediately\&. This is equivalent to apachectl2 -k graceful-stop\&.
.TP
configtest
-Run a configuration file syntax test\&. It parses the configuration files and either reports Syntax Ok or detailed information about the particular syntax error\&. This is equivalent to apachectl -t\&.
+Run a configuration file syntax test\&. It parses the configuration files and either reports Syntax Ok or detailed information about the particular syntax error\&. This is equivalent to apachectl2 -t\&.
.PP
The following option was available in earlier versions but has been removed\&.
@@ -91,5 +91,5 @@ The following option was available in earlier versions
.TP
startssl
-To start httpd with SSL support, you should edit your configuration file to include the relevant directives and then use the normal apachectl start\&.
+To start httpd2 with SSL support, you should edit your configuration file to include the relevant directives and then use the normal apachectl2 start\&.