From owner-freebsd-doc  Thu Jun 24  8:50:15 1999
Delivered-To: freebsd-doc@freebsd.org
Received: from axl.noc.iafrica.com (axl.noc.iafrica.com [196.31.1.175])
	by hub.freebsd.org (Postfix) with ESMTP id A2D5614D20
	for <freebsd-doc@freebsd.org>; Thu, 24 Jun 1999 08:50:04 -0700 (PDT)
	(envelope-from sheldonh@axl.noc.iafrica.com)
Received: from sheldonh (helo=axl.noc.iafrica.com)
	by axl.noc.iafrica.com with local-esmtp (Exim 3.02 #1)
	id 10xBlL-000Hbb-00
	for freebsd-doc@freebsd.org; Thu, 24 Jun 1999 17:50:03 +0200
From: Sheldon Hearn <sheldonh@uunet.co.za>
To: freebsd-doc@freebsd.org
Subject: Revising the rc.conf-related manpages
Date: Thu, 24 Jun 1999 17:50:03 +0200
Message-ID: <67678.930239403@axl.noc.iafrica.com>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


Hi folks,

It doesn't look like our manual pages have been updated to reflect the
use of /etc/defaults/rc.conf . I'm willing to work on it and want some
guidance (or a quick message letting me know that someone else is taking
care of this).

So far, I've got a small diff for rc.conf(5) and wanted to know whether
it's acceptable, if not what's wrong and what else would need to be
updated to complete the revision.

Please ensure that feedback comes to my address, as I don't subscribe to
the list.

Thanks,
Sheldon.

Index: rc.conf.5
===================================================================
RCS file: /home/ncvs/src/share/man/man5/rc.conf.5,v
retrieving revision 1.30
diff -u -d -r1.30 rc.conf.5
--- rc.conf.5	1999/03/29 17:22:47	1.30
+++ rc.conf.5	1999/06/24 15:49:41
@@ -30,9 +30,6 @@
 .Sh NAME
 .Nm rc.conf
 .Nd system configuration information.
-.Pp
-.Nm rc.conf.local
-.Nd localized system configuration information.
 .Sh DESCRIPTION
 The file
 .Nm rc.conf
@@ -43,16 +40,8 @@
 file is generally initialized by the system installation utility:
 .Pa /stand/sysinstall .
 .Pp
-The 
-.Nm rc.conf.local
-file may be used to override variables set in rc.conf.  The system
-administrator typically uses the distribution-supplied 
-.Nm rc.conf 
-file and maintains local overrides/additions in 
-.Nm rc.conf.local.
-.Pp
 The purpose of
-.Nm rc.conf[.local]
+.Nm rc.conf
 is not to run commands or perform system startup actions
 directly.  Instead, it is included by the
 various generic startup scripts in
@@ -60,6 +49,21 @@
 which conditionalize their
 internal actions according to the settings found there.
 .Pp
+The
+.Pa /etc/rc.conf
+file is included from the file
+.Pa /etc/defaults/rc.conf ,
+which specifies the default settings for all the available options. Options
+need only be specified in 
+.Pa /etc/rc.conf
+when the system administrator wishes to override these defaults. The file
+.Pa /etc/rc.conf.local
+is used to override settings in
+.Pa /etc/rc.conf
+for historical reasons. See the
+.Dq rc_conf_files
+option below.
+.Pp
 The following list provides a name and short description for each
 variable you can set in the
 .Nm
@@ -196,6 +200,15 @@
 .Ed
 Then note that alias4 would \fBnot\fR be added since the search would
 stop with the missing alias3 entry.
+.It Ar rc_conf_files
+(str) This option is used to specify a list of files that will override
+the settings in
+.Pa /etc/defaults/rc.conf .
+The files will be read in the order in which they are specified and should
+include the full path to the file. By default, the files specified are
+.Pa /etc/rc.conf
+and
+.Pa /etc/rc.conf.local
 .It Ar syslogd_enable
 (bool) If set to
 .Ar YES ,
@@ -944,6 +957,10 @@
 for the list of possible security levels and their effect
 on system operation.
 .Sh FILES
+.Bl -tag -width /etc/defaults/rc.conf -compact
+.It Pa /etc/defaults/rc.conf
+.El
+.Pp
 .Bl -tag -width /etc/rc.conf -compact
 .It Pa /etc/rc.conf
 .El


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message