From nobody@FreeBSD.org  Tue Jan 13 02:25:28 2009
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 08323106564A
	for <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <freebsd-gnats-submit@FreeBSD.org>; 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 <kaduk@mit.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: misleading loader documentation in handbook
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         130482
>Category:       docs
>Synopsis:       [patch] misleading loader documentation in handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jan 13 02:30:03 UTC 2009
>Closed-Date:    Wed Jan 14 08:40:04 UTC 2009
>Last-Modified:  Wed Jan 14 08:50:01 UTC 2009
>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 @@
          <listitem>
            <para>Immediately proceeds to boot the kernel, with the
              given options, if any, and with the kernel name given,
-             if it is.</para>
+             if it is.  Providing a kernel name on the command-line
+             is only applicable after an <term>unlad</term> command
+             has been issued, otherwise the previously-loaded kernel
+             will be used.</para>
          </listitem>
        </varlistentry>


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Wed Jan 14 08:39:09 UTC 2009 
State-Changed-Why:  
Slightly modified version of your patch committed, it 
seems you are not allowed to use <term> there.  Thanks! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Wed Jan 14 08:39:09 UTC 2009 
Responsible-Changed-Why:  
Over to me 

http://www.freebsd.org/cgi/query-pr.cgi?pr=130482 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/130482: commit references a PR
Date: Wed, 14 Jan 2009 08:39:00 +0000 (UTC)

 trhodes     2009-01-14 08:38:50 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/boot chapter.sgml 
   Log:
   You cannot boot two kernels at once, mention the "unload" command.
   
   PR:             130482
   Submitted by:   Ben Kaduk <kaduk@mit.edu>
   
   Revision  Changes    Path
   1.69      +4 -1      doc/en_US.ISO8859-1/books/handbook/boot/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
