Date: Fri, 30 Jan 2004 03:51:33 -0800 (PST) From: Eric Masson <e-masson@kisoft-services.com> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/62109: Documentation change request Message-ID: <200401301151.i0UBpXbp064140@www.freebsd.org> Resent-Message-ID: <200401301200.i0UC0Ytx067840@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 62109
>Category: docs
>Synopsis: Documentation change request
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: change-request
>Submitter-Id: current-users
>Arrival-Date: Fri Jan 30 04:00:34 PST 2004
>Closed-Date:
>Last-Modified:
>Originator: Eric Masson
>Release: 4.9-RELEASE
>Organization:
>Environment:
FreeBSD t39bsdems.interne.kisoft-services.com 4.9-STABLE FreeBSD 4.9-STABLE #0: Sat Nov 15 21:13:58 CET 2003 emss@t39bsdems.interne.kisoft-services.com:/usr/obj/usr/src/sys/TP390PNP i386
>Description:
It seems that section "Using make world" of chapter "The Cutting Edge" of the handbook is a little confusing for new readers about the way to update the system, this patch tries to solve the issue.
>How-To-Repeat:
>Fix:
--- /usr/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml.old Mon Dec 29 14:52:26 2003
+++ /usr/doc/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml Fri Jan 30 12:07:20 2004
@@ -587,6 +587,27 @@
asking for trouble.</para>
</warning>
+ <para>The canonical way to update your system is the following :
+ </para>
+
+ <itemizedlist>
+ <listitem><para>make buildworld</para></listitem>
+ <listitem><para>make buildkernel</para></listitem>
+ <listitem><para>make installkernel</para></listitem>
+ <listitem><para>reboot in single user mode</para></listitem>
+ <listitem><para>make installworld</para></listitem>
+ <listitem><para>mergemaster</para></listitem>
+ <listitem><para>reboot</para></listitem>
+ </itemizedlist>
+
+ <warning>
+ <title>Read further explanations</title>
+
+ <para>The sequence described above is only a short resume to
+ help you getting started. You should however read the following
+ sections to clearly understand each step.</para>
+ </warning>
+
<sect2>
<title>Read <filename>/usr/src/UPDATING</filename></title>
>Release-Note:
>Audit-Trail:
>Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200401301151.i0UBpXbp064140>