some cleanup..

1 files changed, 39 insertions, 35 deletions

diff --git a/share/man/man8/rc.8 b/share/man/man8/rc.8
index 90377593691..4ea8fd3399e 100644
--- a/share/man/man8/rc.8
+++ b/share/man/man8/rc.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rc.8,v 1.6 1999/07/09 13:35:36 aaron Exp $
+.\"	$OpenBSD: rc.8,v 1.7 1999/07/20 06:20:03 deraadt Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -40,26 +40,31 @@
 .Nm rc
 .Nd command script for auto\-reboot and daemons
 .Sh SYNOPSIS
-.Nm rc
-.Nm rc.local
-.Nm rc.securelevel
-.Nm netstart
+.Nm /etc/rc
+.Nm /etc/rc.local
+.Nm /etc/rc.securelevel
+.Nm /etc/netstart
+.Nm /etc/rc.shutdown
 .Sh DESCRIPTION
 .Nm rc
 is the command script that is invoked by
 .Xr init 8
 during an automatic reboot and after single user mode is exited;
 it performs system housekeeping chores and starts up system daemons.
-.Nm rc.local
-is the script holding commands which are pertinent only
-to a specific site.
-.Nm rc.securelevel
-is the script which runs commands that must be run before the
-security level changes.
+As well,
+.Nm rc
+is intricately tied to the
 .Nm netstart
-is the script which commands and daemons pertaining to the network.
-All of these are controlled in part by
-.Xr rc.conf 8
+script, which runs commands and daemons pertaining to the network.
+The
+.Nm rc.securelevel
+and
+.Nm rc.local
+scripts hold commands which are pertinent only to a specific site.
+.Pp
+All four of these startup scripts are (or can be) controlled to some
+extent by variables defined in
+.Xr rc.conf 8 , Ns
 which specifies which daemons and services are to be run.
 .Pp
 When an automatic reboot is in progress,
@@ -85,21 +90,35 @@ which is run after an auto-reboot succeeds and also if
 .Nm rc
 is invoked when a single user shell terminates (see
 .Xr init 8 ) ,
-and then mounts filesystems, starts system daemons, preserves editor files,
+then asks
+.Xr rc.conf 8
+for configuration variables,
+mounts filesystems, starts system daemons,
+preserves editor files,
 clears the scratch directory
 .Pa /tmp ,
 and saves any possible core image that might have been
 generated as a result of a system crash, with
 .Xr savecore 8 .
 .Pp
+Before
+.Nm rc
+starts most system daemons,
+.Nm netstart
+is executed.
 .Nm netstart
+defines the machine's name, configures various  network interfaces
+and system features, initializes the routing table, and numerous
+other tasks.
+.Pp
+.Nm rc.securelevel
 is executed by
 .Nm rc
-before the system daemons are run.
-.Nm netstart
-defines the machine's name, configures any network interfaces,
-initializes the routing table, and optionally, starts the ip filter
-daemon.
+to start daemons that must run before the security level changes.
+Following this,
+.Nm rc
+then sets the security level to the values specified in
+.Xr rc.conf 8 .
 .Pp
 .Nm rc.local
 is executed towards the end of
@@ -111,21 +130,6 @@ Normally,
 contains commands and daemons that are not part of the
 stock installation.
 .Pp
-.Nm rc.securelevel
-is executed by
-.Nm rc
-to start daemons that must run before the security level changes.
-It then sets the security level to the values specified in
-.Xr rc.conf 8 .
-.Pp
-Following tradition, the startup files
-.Nm rc ,
-.Nm rc.local ,
-.Nm rc.securelevel ,
-and
-.Nm netstart
-reside in
-.Pa /etc .
 .Sh SEE ALSO
 .Xr sysctl.conf 5 ,
 .Xr init 8 ,