Em 10-02-2014 18:28, Mark Kettenis escreveu: >> Date: Mon, 10 Feb 2014 18:05:38 -0200 >> From: Giancarlo Razzolini <grazzol...@gmail.com> >> >> 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?
Cheers, -- Giancarlo Razzolini GPG: 4096R/77B981BC
