From owner-freebsd-doc@FreeBSD.ORG Sat Nov 29 07:37:14 2003 Return-Path: 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 0632C16A4CE for ; Sat, 29 Nov 2003 07:37:14 -0800 (PST) Received: from fledge.watson.org (fledge.watson.org [204.156.12.50]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0232A43FB1 for ; Sat, 29 Nov 2003 07:37:13 -0800 (PST) (envelope-from robert@fledge.watson.org) Received: from fledge.watson.org (localhost [127.0.0.1]) by fledge.watson.org (8.12.9p2/8.12.9) with ESMTP id hATFYbMg057439; Sat, 29 Nov 2003 10:34:37 -0500 (EST) (envelope-from robert@fledge.watson.org) Received: from localhost (robert@localhost)hATFYaYu057436; Sat, 29 Nov 2003 10:34:37 -0500 (EST) (envelope-from robert@fledge.watson.org) Date: Sat, 29 Nov 2003 10:34:36 -0500 (EST) From: Robert Watson X-Sender: robert@fledge.watson.org To: doc@FreeBSD.org Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: Tom Van Vleck Subject: Errant reference to "make world" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 29 Nov 2003 15:37:14 -0000 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. 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? Thanks, Robert N M Watson FreeBSD Core Team, TrustedBSD Projects robert@fledge.watson.org Senior Research Scientist, McAfee Research