Date: Sat, 29 Nov 2003 12:27:48 -0500 (EST) From: Robert Watson <rwatson@FreeBSD.org> To: Marc Fonvieille <blackend@FreeBSD.org> Cc: doc@FreeBSD.org Subject: Re: Errant reference to "make world" Message-ID: <Pine.NEB.3.96L.1031129105514.34660G-100000@fledge.watson.org> In-Reply-To: <20031129165651.A57468@abigail.blackend.org>
index | next in thread | previous in thread | raw e-mail
On Sat, 29 Nov 2003, Marc Fonvieille wrote: > On Sat, Nov 29, 2003 at 10:34:36AM -0500, Robert Watson wrote: > > > > A co-worker of mine just wisely pointed out that the reason people keep > > shooting their feet by using "make world" instead of the documented > > upgrade procedure is that we keep telling them to do so (doh): > > > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/current-stable.html > > > > Before compiling FreeBSD-CURRENT, read the Makefile in /usr/src > > carefully. You should at least run a make world the first time > > through as part of the upgrading process. Reading the FreeBSD-CURRENT > > mailing list and /usr/src/UPDATING will keep you up-to-date on other > > bootstrapping procedures that sometimes become necessary as we move > > toward the next release. > > > > the "make world" words are a link to > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html > > which is very well documented, it seems difficult to do more, however > maybe some parts need a rewording. The problem is that "make world" is both a set of instructions, and a link. Could we change the link text to read: "You should at least <install a new kernel and rebuild the world> the first time through..." To avoid confusing commands with descriptive text? I agree that the instructions in the handbook are quite sufficient on the linked page. Robert N M Watson FreeBSD Core Team, TrustedBSD Projects robert@fledge.watson.org Senior Research Scientist, McAfee Researchhelp
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Pine.NEB.3.96L.1031129105514.34660G-100000>