From swear@aa.net Tue Aug 7 10:21:08 2001 Return-Path: Received: from localhost.localdomain (host68.207.55.120.aadsl.com [207.55.120.68]) by hub.freebsd.org (Postfix) with ESMTP id 469F237B405 for ; Tue, 7 Aug 2001 10:21:08 -0700 (PDT) (envelope-from swear@aa.net) Received: (from jojo@localhost) by localhost.localdomain (8.11.3/8.11.3) id f77HNJC48634; Tue, 7 Aug 2001 10:23:19 -0700 (PDT) (envelope-from swear@aa.net) Message-Id: Date: 07 Aug 2001 10:23:19 -0700 From: swear@aa.net (Gary W. Swearingen) Sender: jojo@localhost.localdomain Reply-To: swear@aa.net To: FreeBSD-gnats-submit@freebsd.org Subject: Handbook missing some "Loader Built-In Commands". X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 29511 >Category: docs >Synopsis: Handbook missing some "Loader Built-In Commands". >Confidential: no >Severity: serious >Priority: medium >Responsible: freebsd-doc >State: closed >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Tue Aug 07 10:30:01 PDT 2001 >Closed-Date: Sun Sep 2 02:36:00 PDT 2001 >Last-Modified: Sun Sep 02 02:36:54 PDT 2001 >Originator: Gary W. Swearingen >Release: FreeBSD 4.3-STABLE i386 >Organization: none >Environment: n/a ================ >Description: Handbook is missing some "Loader Built-In Commands" and descriptions in the "boot" chapter, namely these: heap, bcachestat, show, unset, pnpscan (and maybe one more - my note, taken during boot, was unclear). An additional trival problem in the same (boot) chapter: The phrase "comprises of" (in a list header) is poor English. ================ >How-To-Repeat: ================ >Fix: For the trivial problem only. Change "comprises of" to "is" with this PR/patch. (A needlessly- wordy alternative is "is comprised of".) patch -d /*/doc/en_US.ISO8859-1/books/handbook/boot < this-PR *** /tmp/chapter.sgml Tue Aug 7 09:56:28 2001 --- chapter.sgml Tue Aug 7 10:08:18 2001 *************** *** 268,274 **** Loader Built-In Commands ! The easy-to-use command set comprises of: --- 268,274 ---- Loader Built-In Commands ! The easy-to-use command set is: >Release-Note: >Audit-Trail: Responsible-Changed-From-To: gnats-admin->freebsd-doc Responsible-Changed-By: dd Responsible-Changed-When: Sat Aug 11 13:09:47 PDT 2001 Responsible-Changed-Why: misfiled http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29511 From: Michael Lucas To: freebsd-gnats-submit@freebsd.org, swear@aa.net Cc: Subject: Re: docs/29511: Handbook missing some "Loader Built-In Commands". Date: Thu, 30 Aug 2001 18:31:21 -0400 Well, this is my first attempt to follow-up someone else's PR: let's see if I can successfully choke gnats. :) Might I suggest the following patch? It addresses this in the simplest possible manner. I don't know if the Project wants to have the Handbook include whole excerpts of man pages when a pointer will probably suffice. --- chapter.sgml-dist Thu Aug 30 11:38:51 2001 +++ chapter.sgml-loadercomms Thu Aug 30 11:58:58 2001 @@ -268,7 +268,9 @@ Loader Built-In Commands - The easy-to-use command set comprises of: + These are the most commonly used loader commands. For a + full discussion of all commands available, see + &man.loader.8; -- Michael Lucas mwlucas@blackhelicopters.org http://www.blackhelicopters.org/~mwlucas/ Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons State-Changed-From-To: open->closed State-Changed-By: murray State-Changed-When: Sun Sep 2 02:36:00 PDT 2001 State-Changed-Why: I've just committed something very similar to Michael's fix. Thanks for the PR! It may take up to 24 hours for this fix to make its way to the web site. http://www.FreeBSD.org/cgi/query-pr.cgi?pr=29511 >Unformatted: