Hi,

Giancarlo Razzolini wrote on Mon, Feb 10, 2014 at 03:18:39PM -0200:

> The main issue here is, that, the human brain, although being this
> wonderful machine, makes a lot of assumptions to fill in the gaps, even
> when there are *no *gaps to be filled. I don't know if the documentation
> needs to be clearer in this specific case.

Even though the misunderstanding does not seem to occur often,
it does seem somewhat unsurprising because a lot of other software
encourages the (imho questionable) practice of copying example
configuration files.

So here is what i came up with to make this clearer without
making it longer or more redundant.

OK?
  Ingo


Index: rc.conf.8
===================================================================
RCS file: /cvs/src/share/man/man8/rc.conf.8,v
retrieving revision 1.20
diff -u -r1.20 rc.conf.8
--- rc.conf.8   17 Mar 2012 14:46:40 -0000      1.20
+++ rc.conf.8   12 Feb 2014 09:40:09 -0000
@@ -49,9 +49,9 @@
 .Nm rc.conf
 untouched, and instead create and edit a new
 .Nm rc.conf.local
-file.
-Variables set in this file will override variables previously set in
-.Nm rc.conf .
+file, setting just those variables whose
+.Nm rc.conf
+default values are intended to be overridden.
 .Pp
 Some variables are used to turn features on or off.
 For example, whether the system runs the

Reply via email to