Date: Sun, 28 May 2000 15:29:32 -0400 From: "Crist J. Clark" <cjc@cc942873-a.ewndsr1.nj.home.com> To: Eric Ogren <eogren@earthlink.net> Cc: John Daniels <jmd526@hotmail.com>, freebsd-questions@FreeBSD.ORG Subject: Re: 4.0-RELEASE to 4.0-STABLE upgrade Message-ID: <20000528152932.H55597@cc942873-a.ewndsr1.nj.home.com> In-Reply-To: <20000528151530.A12647@earthlink.net>; from eogren@earthlink.net on Sun, May 28, 2000 at 03:15:30PM -0400 References: <20000528184808.46909.qmail@hotmail.com> <20000528151530.A12647@earthlink.net>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sun, May 28, 2000 at 03:15:30PM -0400, Eric Ogren wrote: > On Sun, May 28, 2000 at 02:48:08PM -0400, John Daniels wrote: > > > > <Caution!, rant to follow:> > > Basically, my complaint was that the handbook says to edit /etc/make.conf > > (specifically to enable options by removing the comment character), but > > doesn't state that the file may need to be copied over. I figured this out > > only *after* I finished, so I didn't have the options you listed above > > (which the handbook states should be there). Simple things like this can > > cause newbies (like myself) some trouble, and generate "stupid" questions on > > mailing lists. Should this be a problem report (PR)? (I have never used > > send-PR, maybe I should try) > > Yup, this is because the handbook is currently slightly out-of-date with > the way things work now. This is known, and will hopefully be addressed > soon. The issue is that /etc/defaults/make.conf is new to 4.0. The handbook is still talking about what to do in 3.x and sometimes 2.2.x in certain parts. I think for now it should contain mention for how to handle both. Submitting a PR as a doc-bug is a perfectly good idea. Like Eric mentions, it is known that parts of the handbook are not up to date, but the best way to get a piece fixed is to do a PR _which includes a good rewrite for the portions you are criticizing._ In this case, write a section that points out what to do for both 3.4-STABLE and 4.0-STABLE. I should also mention that you really should not copy /etc/defaults/make.conf to /etc/make.conf. Only include overrides in /etc/make.conf. There are several reasons for this, and you should not get into the habit of doing it. e.g. If you copy /etc/defaults/rc.conf to /etc/rc.conf, it will actually break your startup. -- Crist J. Clark cjclark@home.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-questions" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000528152932.H55597>