From swear@aa.net  Tue Aug  7 10:21:08 2001
Return-Path: <swear@aa.net>
Received: from localhost.localdomain (host68.207.55.120.aadsl.com [207.55.120.68])
	by hub.freebsd.org (Postfix) with ESMTP id 469F237B405
	for <FreeBSD-gnats-submit@freebsd.org>; 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: <wf7kwfwzqw.kwf@localhost.localdomain>
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:
<code/input/activities to reproduce the problem (multiple lines)>
================
>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 ****
      <sect3 id="boot-loader-commands">
        <title>Loader Built-In Commands</title>
        
!       <para>The easy-to-use command set comprises of:</para>
  
        <variablelist>
  	<varlistentry>
--- 268,274 ----
      <sect3 id="boot-loader-commands">
        <title>Loader Built-In Commands</title>
        
!       <para>The easy-to-use command set is:</para>
  
        <variablelist>
  	<varlistentry>
>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 <mwlucas@blackhelicopters.org>
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 @@
      <sect3 id="boot-loader-commands">
        <title>Loader Built-In Commands</title>
        
 -      <para>The easy-to-use command set comprises of:</para>
 +      <para>These are the most commonly used loader commands.  For a
 +      full discussion of all commands available, see
 +      &man.loader.8;</para>
  
        <variablelist>
  	<varlistentry>
 
 
 
 -- 
 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:
