Em 10-02-2014 19:34, Marco S Hyman escreveu: >> The existing text, "Create and edit a _new_ rc.conf.local file" seems >> fine to me - man pages are generally non-verbose - if copying was intended, >> the manual would have said so. > Disagree. "Create and edit..." is ambiguous. I can create > a new file by copying an old file and often do so. If you > want the new file start out empty then say so. > > We strongly suggest you do not alter > .Nm rc.conf . > Instead, create an empty file named > .Nm rc.conf.local . > Edit the new file ... blah blah blah > > Follows the diff suggesting the creation of an empty file. Stuart, I don't think that in this case it's verbose. It's only changing the idea of advisable with a strong suggestion. The "strong", makes all difference, specifically in the case mentioned on misc@, where the poster did not carefully read the man page. As I mentioned, our brain try to fill in the gaps and in this case, the word strong might shout: "Hey, this is important, pay attention". But since I'm not a native English speaker, perhaps someone could suggest a change in the text both of the man page and the faq.
Index: share/man/man8/rc.conf.8 =================================================================== RCS file: /cvs/src/share/man/man8/rc.conf.8,v retrieving revision 1.20 diff -u -p -u -r1.20 rc.conf.8 --- share/man/man8/rc.conf.8 17 Mar 2012 14:46:40 -0000 1.20 +++ share/man/man8/rc.conf.8 10 Feb 2014 21:36:58 -0000 @@ -45,11 +45,13 @@ in the series in order to set shell variables used therein to control the behaviour of the scripts. .Pp -It is advisable to leave +We strongly suggest you do not alter .Nm rc.conf -untouched, and instead create and edit a new +itself. Instead create an empty file named .Nm rc.conf.local -file. +file and copy only the variables you wish to change from +.Nm rc.conf +and adjust them as you like. Variables set in this file will override variables previously set in .Nm rc.conf . .Pp -- Giancarlo Razzolini GPG: 4096R/77B981BC
