Bug 13194

Summary: Bad info in handbook/kernelconfig
Product: Documentation Reporter: eagle <eagle>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description eagle 1999-08-17 10:10:02 UTC
The handbook chapter on building the kernel suggest that if config wont
rebuild your kernel you update just config...

this is bogus
Comment 1 Sheldon Hearn freebsd_committer freebsd_triage 1999-08-17 12:42:49 UTC
> 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.
Comment 2 eagle 1999-08-24 10:12:11 UTC
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
Comment 3 Sheldon Hearn 1999-08-24 10:25:12 UTC
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.
Comment 4 eagle 1999-08-24 11:02:56 UTC
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>
Comment 5 Sheldon Hearn 1999-08-24 11:16:22 UTC
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.
Comment 6 Sheldon Hearn freebsd_committer freebsd_triage 1999-10-01 13:05:14 UTC
State Changed
From-To: open->closed

Timed out.