From owner-freebsd-doc@FreeBSD.ORG  Tue Jan 23 05:12:32 2007
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@freebsd.org
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id 6AAEA16A402
	for <freebsd-doc@freebsd.org>; Tue, 23 Jan 2007 05:12:32 +0000 (UTC)
	(envelope-from applecom@inbox.ru)
Received: from mx27.mail.ru (mx27.mail.ru [194.67.23.64])
	by mx1.freebsd.org (Postfix) with ESMTP id 299ED13C469
	for <freebsd-doc@freebsd.org>; Tue, 23 Jan 2007 05:12:32 +0000 (UTC)
	(envelope-from applecom@inbox.ru)
Received: from [85.115.165.63] (port=41439 helo=xml.opera.com)
	by mx27.mail.ru with asmtp 
	id 1H9DxN-0007VH-00; Tue, 23 Jan 2007 08:12:29 +0300
Date: Tue, 23 Jan 2007 10:12:29 +0500
To: "John Baldwin" <jhb@freebsd.org>
From: applecom@inbox.ru
Content-Type: text/plain; format=flowed; delsp=yes; charset=iso-8859-1
MIME-Version: 1.0
References: <200701171832.28368.dienst@marcrenearns.de>
	<200701221111.56264.jhb@freebsd.org>
	<1169489832.11889.64.camel@opus.cse.buffalo.edu>
	<200701221341.46518.jhb@freebsd.org>
Content-Transfer-Encoding: 7bit
Message-ID: <op.tmlcqyhvhbloih@xml.opera.com>
In-Reply-To: <200701221341.46518.jhb@freebsd.org>
User-Agent: Opera Mail/9.10 (FreeBSD)
Cc: freebsd-doc@freebsd.org
Subject: Re: make buildkernel fails without complete source tree
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
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: Tue, 23 Jan 2007 05:12:32 -0000

John Baldwin <jhb@freebsd.org> wrote:
> Yes, but the thread started because someone installed 'ssys' and tried to
> build it using 'buildkernel' because that's what the handbook mentions.   
> In
> fact, the handbook doesn't even mention the old way anymore at all, so  
> for
> new users ssys for all intents and purposes does depend on sbase.

To my mind Handbook ('8.3 Building and Installing a Custom Kernel' and  
'21.4 Rebuilding "world"')
should contain an appropriate paragraphs from /usr/src/UPDATING with  
head-note and comments. What do you/we need two variants of docs about  
system update for? Of course one have precedence of other but maybe better  
to have one (w/o and w/ comments)?
Apropos if you/we care about clarity of Handbook, the title 'Rebuilding  
"world"' is not very clear especially for new users. (But on the other  
side maybe it makes reading not so dull?..)

About easy commands for building and installing a kernel: i think that  
'easy' kernel targets can be added to /usr/src/sys Makefile(s) and  
/usr/src Makefile(s) may refer to it.

Handbook is conflicting with /usr/src/UPDATING now:
Handbook: '21.4.14.5. How can I speed up making the world?'
'Pass the -jn option to make(1) to run multiple processes in parallel.  
This usually helps regardless of whether you have a single or a multi  
processor machine.'
UPDATING: 'Avoid using make -j when upgrading. <..>'