From owner-freebsd-doc@FreeBSD.ORG Fri Jan 30 04:00:37 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3CFBA16A4CE for ; Fri, 30 Jan 2004 04:00:37 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CD92143D31 for ; Fri, 30 Jan 2004 04:00:34 -0800 (PST) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) i0UC0YFR067848 for ; Fri, 30 Jan 2004 04:00:34 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.10/8.12.10/Submit) id i0UC0Ytx067840; Fri, 30 Jan 2004 04:00:34 -0800 (PST) (envelope-from gnats) Resent-Date: Fri, 30 Jan 2004 04:00:34 -0800 (PST) Resent-Message-Id: <200401301200.i0UC0Ytx067840@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Eric Masson Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C110016A4CE for ; Fri, 30 Jan 2004 03:51:34 -0800 (PST) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 910A143D45 for ; Fri, 30 Jan 2004 03:51:33 -0800 (PST) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.12.10/8.12.10) with ESMTP id i0UBpXdL064141 for ; Fri, 30 Jan 2004 03:51:33 -0800 (PST) (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.12.10/8.12.10/Submit) id i0UBpXbp064140; Fri, 30 Jan 2004 03:51:33 -0800 (PST) (envelope-from nobody) Message-Id: <200401301151.i0UBpXbp064140@www.freebsd.org> Date: Fri, 30 Jan 2004 03:51:33 -0800 (PST) From: Eric Masson To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.0 Subject: docs/62109: Documentation change request X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 30 Jan 2004 12:00:37 -0000 >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. + The canonical way to update your system is the following : + + + + make buildworld + make buildkernel + make installkernel + reboot in single user mode + make installworld + mergemaster + reboot + + + + Read further explanations + + 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. + + Read <filename>/usr/src/UPDATING</filename> >Release-Note: >Audit-Trail: >Unformatted: