From owner-freebsd-doc  Wed Jul 26  3:50: 5 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21])
	by hub.freebsd.org (Postfix) with ESMTP id 5EDB737BE0D
	for <freebsd-doc@freebsd.org>; Wed, 26 Jul 2000 03:50:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.9.3/8.9.2) id DAA96886;
	Wed, 26 Jul 2000 03:50:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 529F137B5F6; Wed, 26 Jul 2000 03:42:06 -0700 (PDT)
Message-Id: <20000726104206.529F137B5F6@hub.freebsd.org>
Date: Wed, 26 Jul 2000 03:42:06 -0700 (PDT)
From: dan@freebsddiary.org
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-1.0
Subject: docs/20191: you don't ALWAYS have to make world before building a kernel
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         20191
>Category:       docs
>Synopsis:       you don't ALWAYS have to make world before building a kernel
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Jul 26 03:50:00 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Dan Langille
>Release:        
>Organization:
The FreeBSD Diary
>Environment:
>Description:
The handbook implies that when building a custom kernel, you need to 
do a build world first. That's not correct.

From http://www.freebsd.org/handbook/kernelconfig-building.html (near 
bottom of page):

For FreeBSD 4.x or later (or upgrading from FreeBSD 3.x to FreeBSD 
4.x or higher), use the following commands (be sure you have built 
world before!):

While correct, if you know what you are doing, we've had people
asking about how to build world, when all they need is a new
kernel.

Someone please verify my claims in the patch for correctness.  Cheers.
>How-To-Repeat:

>Fix:
--- chapter.sgml.original       Sat Jul 22 17:50:25 2000
+++ chapter.sgml        Sat Jul 22 18:09:47 2000
@@ -155,7 +155,8 @@
 &prompt.root; <userinput>make install</userinput></screen>
 
     <para>For FreeBSD 4.x or later (or upgrading from FreeBSD 3.x to
-      FreeBSD 4.x or higher), use the following commands (be sure you
+      FreeBSD 4.x or higher), use the following commands (and if you are
+      upgrading FreeBSD, e.g. 3 to 4 or -release to -stable, be sure you
       have built world before you build the kernel!):</para>
 
     <screen>&prompt.root; <userinput>cd /usr/src</userinput>

>Release-Note:
>Audit-Trail:
>Unformatted:


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message