From owner-freebsd-doc@FreeBSD.ORG  Sat Nov 29 07:56:56 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 4EB8416A4CE; Sat, 29 Nov 2003 07:56:56 -0800 (PST)
Received: from abigail.blackend.org (blackend.org [212.11.35.229])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 58CE343FE3; Sat, 29 Nov 2003 07:56:54 -0800 (PST)
	(envelope-from marc@blackend.org)
Received: from abigail.blackend.org (localhost [127.0.0.1])
	by abigail.blackend.org (8.12.9/8.12.3) with ESMTP id hATFuqB0061008;
	Sat, 29 Nov 2003 16:56:52 +0100 (CET)
	(envelope-from marc@abigail.blackend.org)
Received: (from marc@localhost)
	by abigail.blackend.org (8.12.9/8.12.3/Submit) id hATFupuM061007;
	Sat, 29 Nov 2003 16:56:51 +0100 (CET)
	(envelope-from marc)
Date: Sat, 29 Nov 2003 16:56:51 +0100
From: Marc Fonvieille <blackend@FreeBSD.org>
To: Robert Watson <rwatson@FreeBSD.org>
Message-ID: <20031129165651.A57468@abigail.blackend.org>
References: <Pine.NEB.3.96L.1031129102954.34660F-100000@fledge.watson.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2.5.1i
In-Reply-To: <Pine.NEB.3.96L.1031129102954.34660F-100000@fledge.watson.org>;
	from rwatson@FreeBSD.org on Sat, Nov 29, 2003 at 10:34:36AM -0500
X-Useless-Header: blackend.org
X-Operating-System: FreeBSD 4.8-STABLE
cc: Tom Van Vleck <tvanvlec@nailabs.com>
cc: doc@FreeBSD.org
Subject: Re: Errant reference to "make world"
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 29 Nov 2003 15:56:56 -0000

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