On 2014/02/10 18:42, Giancarlo Razzolini wrote: > Em 10-02-2014 18:28, Mark Kettenis escreveu: > >> Date: Mon, 10 Feb 2014 18:05:38 -0200 > >> From: Giancarlo Razzolini <[email protected]> > >> > >> As mentioned before on misc@, some user got confused and copied the > >> entire rc.conf file to rc.conf.local and then proceeded editing it. This > >> patch brings the rc.conf man page closer to the text that is in the > >> OpenBSD faq. Hopefully it will help newcomers avoiding this mistake. > > I think your new text is not an improvement. > > > >> 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 19:59:00 -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 and edit a new > >> .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 > >> > >> > The text on the faq should be revised then. This patch only makes the > text on the man page closer to the faq. I believe that the man pages are > to be considered the de facto source for documentation, not the other > way around. What's your suggestion for the text?
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. The faq is more chatty, and I don't see a problem with the faq's text in this area either..
