From owner-freebsd-doc@FreeBSD.ORG Tue Jan 13 22:00:44 2009 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id CF05D1065673 for ; Tue, 13 Jan 2009 22:00:44 +0000 (UTC) (envelope-from frank@esperance-linux.co.uk) Received: from mailout.zetnet.co.uk (mailout.zetnet.co.uk [194.247.47.231]) by mx1.freebsd.org (Postfix) with ESMTP id 5C5E18FC17 for ; Tue, 13 Jan 2009 22:00:43 +0000 (UTC) (envelope-from frank@esperance-linux.co.uk) Received: from irwell.zetnet.co.uk ([194.247.47.48] helo=zetnet.co.uk) by mailout.zetnet.co.uk with esmtp (Exim 4.63) (envelope-from ) id 1LMrJO-000410-KD; Tue, 13 Jan 2009 22:00:38 +0000 Received: from melon.esperance-linux.co.uk (54-144.adsl.zetnet.co.uk [194.247.54.144]) by zetnet.co.uk (8.14.1/8.14.1/Debian-9) with ESMTP id n0DM0b54015317; Tue, 13 Jan 2009 22:00:37 GMT Received: by melon.esperance-linux.co.uk (Postfix, from userid 1001) id C627EFCA4DC; Tue, 13 Jan 2009 22:00:31 +0000 (GMT) Date: Tue, 13 Jan 2009 22:00:31 +0000 From: Frank Shute To: Ben Kaduk Message-ID: <20090113220031.GA20634@melon.esperance-linux.co.uk> Mail-Followup-To: Ben Kaduk , freebsd-doc@freebsd.org References: <200901130225.n0D2PRJX015696@www.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200901130225.n0D2PRJX015696@www.freebsd.org> User-Agent: Mutt/1.4.2.3i X-Face: *}~{PHnDTzvXPe'wl_-f%!@+r5; VLhb':*DsX%wEOPg\fDrXWQJf|2\,92"DdS%63t*BHDyQ|OWo@Gfjcd72eaN!4%NE{0]p)ihQ1MyFNtWL X-Operating-System: FreeBSD 6.4-RELEASE-p2 i386 X-Organisation: 'http://www.shute.org.uk/' X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.1.7 (zetnet.co.uk [194.247.46.1]); Tue, 13 Jan 2009 22:00:38 +0000 (GMT) Cc: freebsd-doc@freebsd.org Subject: Re: docs/130482: misleading loader documentation in handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Frank Shute List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 13 Jan 2009 22:00:46 -0000 On Tue, Jan 13, 2009 at 02:25:27AM +0000, Ben Kaduk wrote: > > > >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: > _______________________________________________ Thought I'd just point out the inlined patch has a typo in it (s/unlad/unload). The one at the URL you gave seems OK though. Regards, -- Frank Contact info: http://www.shute.org.uk/misc/contact.html