From owner-freebsd-doc@FreeBSD.ORG Sun May 11 01:35:46 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 0DE1437B40E for ; Sun, 11 May 2003 01:35:42 -0700 (PDT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 075D043FDD for ; Sun, 11 May 2003 01:35:40 -0700 (PDT) (envelope-from trhodes@FreeBSD.org) Received: from mobile.pittgoth.com ([192.168.0.5]) by pittgoth.com (8.12.9/8.12.9) with SMTP id h4B8ZcZK068886; Sun, 11 May 2003 04:35:38 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Sun, 11 May 2003 04:30:58 -0400 From: Tom Rhodes To: swear@attbi.com (Gary W. Swearingen) Message-Id: <20030511043058.4088711d.trhodes@FreeBSD.org> In-Reply-To: References: <20030510151718.D2044@wonkity.com> <20030510185024.4b05ffaf.trhodes@FreeBSD.org> X-Mailer: Sylpheed version 0.8.10claws (GTK+ 1.2.10; i386-portbld-freebsd5.1) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: doc@FreeBSD.org Subject: Re: Handbook: Using "make world" Chapter 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: Sun, 11 May 2003 08:35:46 -0000 On 10 May 2003 20:24:13 -0700 swear@attbi.com (Gary W. Swearingen) wrote: > Tom Rhodes writes: > > > AFAIK, make world still works (least it did for me yesterday on a CURRENT > > box) and don't see it becoming deprecated any time soon. > > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/makeworld.html > says: > > Although the world target still exists, you are strongly encouraged > not to use it. > > Looks deprecated to me, but then I seldom use that term because I > greatly dislike reading it myself when I don't know who's doing the > deprecating and/or why. I've seen too many cases where there was no > good reason for the deprecation. I think such suggestions or opinions > should be omitted unless maybe they are more carefully written: > > Almost all users will find it best to use "make buildworld" in > multi-user mode and "make installworld in single-user mode, for > reasons explained above, so few will want to use "make world". > > > Honestly, I don't see how its confusing. Perhaps if we discussed make world > > throughout the entire document, but gave the commands for buildworld, that > > would be a problem. What do you think would be better in terms of 'more > > descriptive'? > > It's confusing because the section (21.4 and also 21.4.10) is entitled > "Using 'make world'", but the section doesn't ever talk about "using > 'make world'" (though one can infer it from an explanation of the > buildworld and installworld targets, and the obviously obsolete > back-handed references to 'make world' in several other places. I think > your "perhaps if" case is the very thing Warren is complaining about. > [SNIP] I'll take your suggestions and see what I can come up with. I've got a hoard of printed pages from the handbook with scribble on them to make changes like: Rewrite this paragraph for clairity. Grammar nits here. Incorrect information here. Information ordering incorrect here. So, I'll add this to my list. Thanks for the suggestions! -- Tom Rhodes