From owner-freebsd-doc@FreeBSD.ORG  Sat Nov 29 09:42:35 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 3E81D16A4CE; Sat, 29 Nov 2003 09:42:35 -0800 (PST)
Received: from abigail.blackend.org (blackend.org [212.11.35.229])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 54AFD43FBD; Sat, 29 Nov 2003 09:42:32 -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 hATHgUB0062031;
	Sat, 29 Nov 2003 18:42:30 +0100 (CET)
	(envelope-from marc@abigail.blackend.org)
Received: (from marc@localhost)
	by abigail.blackend.org (8.12.9/8.12.3/Submit) id hATHgTAU062030;
	Sat, 29 Nov 2003 18:42:29 +0100 (CET)
	(envelope-from marc)
Date: Sat, 29 Nov 2003 18:42:29 +0100
From: Marc Fonvieille <blackend@FreeBSD.org>
To: Robert Watson <rwatson@FreeBSD.org>
Message-ID: <20031129184229.B57468@abigail.blackend.org>
References: <20031129165651.A57468@abigail.blackend.org>
	<Pine.NEB.3.96L.1031129105514.34660G-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.1031129105514.34660G-100000@fledge.watson.org>;
	from rwatson@FreeBSD.org on Sat, Nov 29, 2003 at 12:27:48PM -0500
X-Useless-Header: blackend.org
X-Operating-System: FreeBSD 4.8-STABLE
cc: doc@FreeBSD.org
cc: Tom Van Vleck <tvanvlec@nailabs.com>
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 17:42:35 -0000

On Sat, Nov 29, 2003 at 12:27:48PM -0500, Robert Watson wrote:
> > 
> > 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. 
> 
> The problem is that "make world" is both a set of instructions, and a
> link.  Could we change the link text to read:
> 
>   "You should at least <install a new kernel and rebuild the world> the
>    first time through..."
> 
> To avoid confusing commands with descriptive text?  I agree that the
> instructions in the handbook are quite sufficient on the linked page.
>

I agree with your suggestion.  If no objection I will fix the link text
in few hours.

Marc