From owner-freebsd-doc@FreeBSD.ORG Tue Jan 13 02:30:04 2009 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 5E1471065674 for ; Tue, 13 Jan 2009 02:30:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 3B0B78FC0A for ; Tue, 13 Jan 2009 02:30:04 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id n0D2U4ej098973 for ; Tue, 13 Jan 2009 02:30:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.3/8.14.3/Submit) id n0D2U40u098970; Tue, 13 Jan 2009 02:30:04 GMT (envelope-from gnats) Resent-Date: Tue, 13 Jan 2009 02:30:04 GMT Resent-Message-Id: <200901130230.n0D2U40u098970@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, Ben Kaduk Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 08323106564A for ; Tue, 13 Jan 2009 02:25:28 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id EAF268FC12 for ; Tue, 13 Jan 2009 02:25:27 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.3/8.14.3) with ESMTP id n0D2PRDe015709 for ; Tue, 13 Jan 2009 02:25:27 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.3/8.14.3/Submit) id n0D2PRJX015696; Tue, 13 Jan 2009 02:25:27 GMT (envelope-from nobody) Message-Id: <200901130225.n0D2PRJX015696@www.freebsd.org> Date: Tue, 13 Jan 2009 02:25:27 GMT From: Ben Kaduk To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/130482: misleading loader documentation in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Jan 2009 02:30:04 -0000 >Number: 130482 >Category: docs >Synopsis: misleading loader documentation in handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Jan 13 02:30:03 UTC 2009 >Closed-Date: >Last-Modified: >Originator: Ben Kaduk >Release: 7.1-PRERELEASE >Organization: MIT SIPB >Environment: FreeBSD periphrasis.mit.edu 7.1-PRERELEASE FreeBSD 7.1-PRERELEASE #5: Sat Jan 3 17:44:27 EST 2009 kadku@periphrasis.mit.edu:/usr/obj/usr/src/sys/PERIPHRASIS amd64 >Description: The handbook chapter on the Boot Manager and boot stages includes section 12.3.3.2 describing the loader built-in commands. The description for the 'boot' command describes the optional kernelname parameter, but does not mention that this parameter is overrided if there is already a kernel image loaded. (The correct procedure to boot a different kernel is mentioned later in the page, though.) >How-To-Repeat: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/boot-blocks.html >Fix: The patch available here is also inlined below: http://stuff.mit.edu/afs/sipb.mit.edu/user/kaduk/freebsd/patches/chapter.boot.diff.20090112 --------------- begin patch here -------------- --- chapter.sgml.orig Mon Jan 12 21:13:56 2009 +++ chapter.sgml Mon Jan 12 21:18:37 2009 @@ -343,7 +343,10 @@ Immediately proceeds to boot the kernel, with the given options, if any, and with the kernel name given, - if it is. + if it is. Providing a kernel name on the command-line + is only applicable after an unlad command + has been issued, otherwise the previously-loaded kernel + will be used. >Release-Note: >Audit-Trail: >Unformatted: