Date: 26 Dec 2001 06:09:01 -0000 From: Mike Meyer <mwm@mired.org> To: FreeBSD-gnats-submit@freebsd.org Subject: docs/33184: The handbook is missing a critical step in the upgrade process Message-ID: <20011226060901.47687.qmail@guru.mired.org>
next in thread | raw e-mail | index | archive | help
>Number: 33184
>Category: docs
>Synopsis: The handbook is missing a critical step in the upgrade process
>Confidential: no
>Severity: critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Tue Dec 25 22:10:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator: Mike Meyer
>Release: FreeBSD 4.4-STABLE i386
>Organization:
Meyer Consulting
>Environment:
System: FreeBSD guru.mired.org 4.4-STABLE FreeBSD 4.4-STABLE #7: Fri Nov 23 03:32:45 CST 2001 mwm@guru.mired.org:/usr/src/sys/compile/ATHLON i386
>Description:
The handbook description of building a new kernel fails to point out
that you can't safely do a "make buildkernel" after updating your
system sources until *after* you've done a "make buildworld".
>How-To-Repeat:
Read the handbook section on building a kernel, and note that the
discussion of "make buildkernel" doesn't mention this requirement at
all.
>Fix:
The attached patch corrects this oversight.
--- handbook/cutting-edge/chapter.sgml.orig Tue Dec 25 23:50:00 2001
+++ handbook/cutting-edge/chapter.sgml Wed Dec 26 00:04:36 2001
@@ -870,7 +870,8 @@
<screen>&prompt.root; <userinput>make <replaceable>target</replaceable></userinput></screen>
- <para>Beginning with version 2.2.5 of &os; (actually, it was
+ <para id="make-buildworld">Beginning with version 2.2.5 of &os;
+ (actually, it was
first created on the &os.current; branch, and then retrofitted to
&os.stable; midway between 2.2.2 and 2.2.5) the
<maketarget>world</maketarget> target has been split in
@@ -971,7 +972,10 @@
<para>If you are upgrading to &os; 4.0 or above then the standard
kernel build procedure (as described in <xref linkend="kernelconfig">)
- is deprecated. Instead, you should run these commands.</para>
+ is deprecated. Instead, you should run these commands
+ <emphasis>after</emphasis> you have <link
+ linkend="make-buildworld">built the world with
+ <maketarget>buildworld</maketarget></link>.</para>
<screen>&prompt.root; <userinput>cd /usr/src</userinput>
&prompt.root; <userinput>make buildkernel</userinput>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20011226060901.47687.qmail>