Errant reference to "make world"

Marc Fonvieille blackend at FreeBSD.org
Sat Nov 29 15:56:56 UTC 2003


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.

> I believe we have a nice chunky section in the Developer's Handbook on
> "The One Right Way", which talks about breaking out kernel and world
> builds, etc.  Could we just make this a cross-reference to the One Right
> Way? 
>

It's what the previous link does; I think the Handbook must contain the
whole procedure to build/install a new system.

Marc



More information about the freebsd-doc mailing list