From owner-freebsd-doc@FreeBSD.ORG Wed Jul 21 21:14:59 2004 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 68ECF16A4CE for ; Wed, 21 Jul 2004 21:14:59 +0000 (GMT) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.FreeBSD.org (Postfix) with ESMTP id 364C943D49 for ; Wed, 21 Jul 2004 21:14:59 +0000 (GMT) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id 835F914316; Wed, 21 Jul 2004 16:14:58 -0500 (CDT) Date: Wed, 21 Jul 2004 16:14:58 -0500 (CDT) From: Mark Linimon X-X-Sender: linimon@pancho To: Ken Smith In-Reply-To: <20040721165642.GA19955@electra.cse.Buffalo.EDU> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII cc: doc@freebsd.org Subject: Re: Handbook update for '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: Wed, 21 Jul 2004 21:14:59 -0000 I don't have any objection to any of this, but I think it might be nice to at least put in the text a) that a change in recommendation has been made, and b) why. Something like 'the sequence that includes "make buildworld/make installworld" is now preferred to the previously documented usage "make world". The latter skips some steps that may or may not be necessary in certain circumstances; the former includes all steps that are necessary in any circumstance, and is thus less likely to lead to unsatisfactory results.' mcl