From owner-freebsd-doc@FreeBSD.ORG  Mon May 12 04:53:40 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 CDE5637B401; Mon, 12 May 2003 04:53:40 -0700 (PDT)
Received: from perrin.int.nxad.com (internal.ext.nxad.com [69.1.70.251])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 6911E43FBD; Mon, 12 May 2003 04:53:40 -0700 (PDT)
	(envelope-from hmp@perrin.int.nxad.com)
Received: by perrin.int.nxad.com (Postfix, from userid 1072)
	id B333D20F01; Mon, 12 May 2003 04:53:39 -0700 (PDT)
Date: Mon, 12 May 2003 04:53:39 -0700
From: Hiten Pandya <hmp@FreeBSD.ORG>
To: Tom Rhodes <trhodes@FreeBSD.org>
Message-ID: <20030512115339.GB63817@perrin.int.nxad.com>
References: <20030510151718.D2044@wonkity.com>
	<20030510185024.4b05ffaf.trhodes@FreeBSD.org>
	<c2u1c24142.1c2@localhost.localdomain>
	<20030511043058.4088711d.trhodes@FreeBSD.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20030511043058.4088711d.trhodes@FreeBSD.org>
User-Agent: Mutt/1.4i
X-Operating-System: FreeBSD FreeBSD 4.7-STABLE
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 <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: Mon, 12 May 2003 11:53:41 -0000

On Sun, May 11, 2003 at 04:30:58AM -0400, Tom Rhodes wrote:
> 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!

	Also, it might help if we mentioned, that the make world target
	is actually a split, ``buildworld'' and ``installworld''.  Last
	time I checked, I didn't see make world installing if the
	compilation stage failed... I may be wrong.
	
	It is also a bad idea to use acronyms, abbreviations, and
	command names in section and chapter titles, IMHO.

	Cheers.
		-- Hiten (hmp@FreeBSD.ORG)