From stephen@cauchy.math.missouri.edu  Mon Jul 24 01:00:55 2000
Return-Path: <stephen@cauchy.math.missouri.edu>
Received: from cauchy.math.missouri.edu (cauchy.math.missouri.edu [128.206.49.166])
	by hub.freebsd.org (Postfix) with ESMTP id 4A25A37B506
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 24 Jul 2000 01:00:54 -0700 (PDT)
	(envelope-from stephen@cauchy.math.missouri.edu)
Received: (from stephen@localhost)
	by cauchy.math.missouri.edu (8.9.3/8.9.1) id DAA01411;
	Mon, 24 Jul 2000 03:00:53 -0500 (CDT)
Message-Id: <200007240800.DAA01411@cauchy.math.missouri.edu>
Date: Mon, 24 Jul 2000 03:00:53 -0500 (CDT)
From: Stephen Montgomery-Smith <stephen@cauchy.math.missouri.edu>
Reply-To: stephen@math.missouri.edu
To: FreeBSD-gnats-submit@freebsd.org
Subject: shouldn't use make buildkernel with release version of FreeBSD
X-Send-Pr-Version: 3.2

>Number:         20136
>Category:       docs
>Synopsis:       shouldn't use make buildkernel with release version of FreeBSD
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 24 01:10:01 PDT 2000
>Closed-Date:    Tue Jul 25 02:32:05 PDT 2000
>Last-Modified:  Tue Jul 25 02:34:27 PDT 2000
>Originator:     Stephen Montgomery-Smith
>Release:        FreeBSD 4.1-RC i386
>Organization:
University of Missouri
>Environment:

>Description:

In the handbook in the web page
http://www.freebsd.org/handbook/kernelconfig-building.html
it tells you that if you are using FreeBSD 4.x or higher, that
when building a custom kernel, you should use the
make buildkernel method instead of the old config method.

This is not going to work with FreeBSD 4.1 release, because
the make buildkernel method requires ALL the sources, not
just /usr/src/sys (which is all the handbook told the user
to load.)

This problem has already generated one question on the newsgroup
comp.unix.bsd.freebsd.misc, and if the handbook goes out like
this when FreeBSD 4.1-release goes out, you will get a load of
people saying that they followed the instructions in the handbook
and got a make: no target to make error.

I made it serious/high priority in the hopes that this will be
fixed before 4.1-release gets out.

I sent a PR like this a few days ago, but I think it got lost -
I certainly had a bad return address on it.  I hope that this
PR does not appear twice.

>How-To-Repeat:

>Fix:

--- kernelconfig-building-orig.html	Sat Jul 22 14:10:21 2000
+++ kernelconfig-building.html	Sat Jul 22 14:21:50 2000
@@ -136,7 +136,8 @@
       </div>
 
       <p>When you are finished, type the following to compile and
-      install your kernel if you are using FreeBSD prior FreeBSD
+      install your kernel if you are using any release version (that
+      is, not stable or current) of FreeBSD, or any version prior to FreeBSD
       4.0 and don't want to upgrade to FreeBSD 4.0 or higher with
       this step.</p>
 
@@ -165,7 +166,9 @@
 "USERINPUT"><b>make install</b></tt>
 </pre>
 
-      <p>For FreeBSD 4.x or later (or upgrading from FreeBSD 3.x to
+      <p>If you are tracking stable or current (that is, you are not
+      using a release version), then 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!):</p>
 <pre class="SCREEN">


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: alex 
State-Changed-When: Tue Jul 25 02:32:05 PDT 2000 
State-Changed-Why:  
I updated the part. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=20136 
>Unformatted:
 Stephen Montgomery-Smith
