docs/62109: Documentation change request

[Eric Masson]

>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 at 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: