From nobody@FreeBSD.ORG Tue Aug 17 02:06:12 1999
Return-Path: <nobody@FreeBSD.ORG>
Received: by hub.freebsd.org (Postfix, from userid 32767)
	id 4C66C14F4E; Tue, 17 Aug 1999 02:06:12 -0700 (PDT)
Message-Id: <19990817090612.4C66C14F4E@hub.freebsd.org>
Date: Tue, 17 Aug 1999 02:06:12 -0700 (PDT)
From: eagle@phc.igs.net
Sender: nobody@FreeBSD.ORG
To: freebsd-gnats-submit@freebsd.org
Subject: Bad info in handbook/kernelconfig
X-Send-Pr-Version: www-1.0

>Number:         13194
>Category:       docs
>Synopsis:       Bad info in handbook/kernelconfig
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Aug 17 02:10:02 PDT 1999
>Closed-Date:    Fri Oct 1 05:05:14 PDT 1999
>Last-Modified:  Fri Oct  1 05:05:31 PDT 1999
>Originator:     Robert Garrett
>Release:        4.0 - current
>Organization:
>Environment:
>Description:
The handbook chapter on building the kernel suggest that if config wont
rebuild your kernel you update just config...

this is bogus
>How-To-Repeat:

>Fix:
Index: chapter.sgml
===================================================================
RCS file: /usr/home/ncvs/doc/en/handbook/kernelconfig/chapter.sgml,v
retrieving revision 1.18
diff -u -r1.18 chapter.sgml
--- chapter.sgml        1999/08/05 20:48:14     1.18
+++ chapter.sgml        1999/08/17 08:56:03
@@ -115,16 +115,7 @@
       overwhelming to you, so follow the descriptions in the <link
        linkend="kernelconfig-config">Configuration File</link> section slowly
       and carefully.</para>
-
-    <note>
-      <para>If you are trying to upgrade your kernel from an older version of
-       FreeBSD, you will probably have to get a new version of
-           &man.config.8; from the same place you got the new kernel sources.
-       It is located in <filename>/usr/src/usr.sbin</filename>, so you will
-       need to download those sources as well.  Re-build and install it
-       before running the next commands.</para>
-    </note>
-
+
     <para>When you are finished, type the following to compile and install
       your kernel:</para>




                                                               

>Release-Note:
>Audit-Trail:

From: Sheldon Hearn <sheldonh@FreeBSD.org>
To: Robert Garrett <eagle@phc.igs.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/13194: Bad info in handbook/kernelconfig
Date: Tue, 17 Aug 1999 13:42:49 +0200

 > The handbook chapter on building the kernel suggest that if config wont
 > rebuild your kernel you update just config...
 > 
 > this is bogus
 
 If that's what the handbook said, I'd agree that it's bogus. But it
 doesn't.
 
 The manpage says that you'll probably need a new config to build a new
 kernel. It doesn't mention breakage at all in the paragraphs you're
 complaining about.
 
 I think it's good advice, since a mismatched config can often cause
 breakage. We're not saying that it's the _only_ cause of breakage.
 
 May I close your PR?
 
 Ciao,
 Sheldon.
 

From: Robert Garrett <eagle@phc.igs.net>
To: freebsd-gnats-submit@freebsd.org, eagle@phc.igs.net,
	sheldonh@freebsd.org
Cc:  
Subject: Re: docs/13194: Bad info in handbook/kernelconfig
Date: Tue, 24 Aug 1999 05:12:11 -0400

 I will, later tonight or tommorrow, rewrite that text so it is a little
 clearer. with all the people coming to freebsd who are from a linux
 background, and used to just upgrading the kernel, leaving  that
 statement alone. and pointing them to this documentation for reference.
 will cause us grief.
 
 Rob
 
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Robert Garrett <eagle@phc.igs.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/13194: Bad info in handbook/kernelconfig 
Date: Tue, 24 Aug 1999 11:25:12 +0200

 On Tue, 24 Aug 1999 05:12:11 -0400, Robert Garrett wrote:
 
 > I will, later tonight or tommorrow, rewrite that text so it is a little
 > clearer.
 
 Feel free to run it by me. However, I honestly think the text is good
 the way it is. A config(8) which is mismatched with the sources is a
 common cause of problems.
 
 Still, let's see your suggestion. :-)
 
 Ciao,
 Sheldon.
 

From: Robert Garrett <eagle@phc.igs.net>
To: freebsd-gnats-submit@freebsd.org, eagle@phc.igs.net,
	sheldonh@freebsd.org
Cc:  
Subject: Re: docs/13194: Bad info in handbook/kernelconfig
Date: Tue, 24 Aug 1999 06:02:56 -0400

 Index: chapter.sgml
 ===================================================================
 RCS file:
 /usr/home/ncvs//doc/en_US.ISO_8859-1/books/handbook/kernelconfig/chapter.sgml,v
 
 retrieving revision 1.19
 diff -d -r1.19 chapter.sgml
 126c126,131
 <     </note>
 ---
 >       <para> WARNING: FreeBSD Is not intended to be upgraded in this
 manner.
 >             if  you are intending to upgrade the whole system please
 use the
 >             make world facilities or do a binary upgrade from
 sysinstall. Other
 >             wise some system utilites such as ps, top, and possibly
 others
 >           might not work as expected.</para>
 >      </note>
 
 
 
 

From: Sheldon Hearn <sheldonh@uunet.co.za>
To: Robert Garrett <eagle@phc.igs.net>
Cc: freebsd-gnats-submit@freebsd.org
Subject: Re: docs/13194: Bad info in handbook/kernelconfig 
Date: Tue, 24 Aug 1999 12:16:22 +0200

 Hi Robert,
 
 Your text probably does more harm than good, and you're putting it in
 the wrong place. I would suggest that text like this would feel more
 comfortable under the "Why Build a Custom Kernel?" section.
 
 I'd just explain that recompiling the kernel does not upgrade FreeBSD,
 and see the section called "The Cutting Edge: FreeBSD-current and
 FreeBSD-stable" for more details on how to upgrade.
 
 Don't mention upgrading with sysinstall, because you usually run into
 problems if you try to upgrade to a later release using an installed
 copy of sysinstall.
 
 Ciao,
 Sheldon.
 
State-Changed-From-To: open->closed 
State-Changed-By: sheldonh 
State-Changed-When: Fri Oct 1 05:05:14 PDT 1999 
State-Changed-Why:  
Timed out. 
>Unformatted:
