From pepper@reppep.com  Fri Jul  5 13:19:17 2002
Return-Path: <pepper@reppep.com>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id 1F1C337B400; Fri,  5 Jul 2002 13:19:17 -0700 (PDT)
Received: from guest.reppep.com (guest.reppep.com [64.81.19.110])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 6F06343E4A; Fri,  5 Jul 2002 13:19:16 -0700 (PDT)
	(envelope-from pepper@reppep.com)
Received: by guest.reppep.com (Postfix, from userid 501)
	id A9B58A944; Fri,  5 Jul 2002 16:19:37 -0400 (EDT)
Message-Id: <20020705201937.A9B58A944@guest.reppep.com>
Date: Fri,  5 Jul 2002 16:19:37 -0400 (EDT)
From: Chris Pepper <pepper@rockefeller.edu>
Reply-To: Chris Pepper <pepper@rockefeller.edu>
To: FreeBSD-gnats-submit@freebsd.org
Cc: Daniel C.Sobral <dcs@FreeBSD.org>
Subject: Typos in loader.conf.5
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         40237
>Category:       docs
>Synopsis:       Typos in loader.conf.5
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 05 13:20:02 PDT 2002
>Closed-Date:    Tue Aug 27 09:42:49 PDT 2002
>Last-Modified:  Tue Aug 27 09:42:49 PDT 2002
>Originator:     Chris Pepper
>Release:        FreeBSD 4.6-STABLE i386
>Organization:
>Environment:
System: FreeBSD guest.reppep.com 4.6-STABLE FreeBSD 4.6-STABLE #2: Fri Jul 5 11:33:25 EDT 2002 root@guest.reppep.com:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	There are several typos and awkward wordings in /usr/share/man/man5/loader.conf.5.gz.
>How-To-Repeat:
	man loader.conf
	
>Fix:
	Apply this patch to fix and clarify the loader.conf man page.

--- loader.conf.5.diff begins here ---
--- loader.conf.5	Fri Jul  5 14:44:14 2002
+++ loader.conf.5.fixed	Fri Jul  5 16:02:31 2002
@@ -34,7 +34,7 @@
 .Nm
 contains descriptive information on bootstrapping the system. Through
 it you can specify the kernel to be booted, parameters to be passed to
-it, additional modules to be loaded, and generally set all variables
+it, and additional modules to be loaded; and generally set all variables
 described in
 .Xr loader 8 .
 .Pp
@@ -58,7 +58,7 @@
 and can be sourced by
 .Xr sh 1 ,
 some settings are treated in a special fashion. Also, the
-behavior of some settings depends only on it's suffix.
+behavior of some settings is defined by the setting's suffix; the prefix identifies which module the setting controls.
 .Pp
 The general parsing rules are:
 .Bl -bullet
@@ -76,12 +76,12 @@
 .Pp
 Unless it belongs to one of the classes of settings that receive special
 treatment, a setting will set the value of a
-.Xr loader 8 Ns 's
+.Xr loader 8
 environment variable. The settings that receive special
-treatment are listed below. The ones beginning with a
+treatment are listed below. Settings beginning with
 .Qq *
-define the modules to be loaded and
-may have any prefix. All such settings sharing a common
+below define the modules to be loaded and
+may have any prefix; the prefix identifies a module. All such settings sharing a common
 prefix refer to the same module.
 .Bl -tag -width Ar
 .It Ar exec
@@ -90,7 +90,7 @@
 command. This type of setting cannot be processed by programs other
 than
 .Xr loader 8 ,
-so it's use should be avoided. Multiple instances of it will be processed
+so its use should be avoided. Multiple instances of it will be processed
 independently.
 .It Ar loader_conf_files
 Defines additional configuration files to be processed right after the
@@ -101,12 +101,12 @@
 .It Ar kernel_options
 Flags to be passed to the kernel.
 .It Ar password
-Provides a password to be asked by check-password before execution is
+Provides a password to be required by check-password before execution is
 allowed to continue.
 .It Ar verbose_loading
 If set to
 .Dq YES ,
-the modules' names will be displayed as they are loaded.
+module names will be displayed as they are loaded.
 .It Ar *_load
 If set to
 .Dq YES ,
@@ -143,7 +143,7 @@
 a bitmap will be loaded to be displayed on screen while booting.
 .It Va bitmap_name
 .Pq Dq /boot/splash.bmp
-Name of the bitmap to be loaded. Any other name can be used.
+Name of the bitmap to be loaded. Any valid bitmap path can be used.
 .It Va kernel
 .Pq Dq /kernel
 .It Va loader_conf_files
@@ -152,13 +152,13 @@
 .Pq Dq NO
 If set to
 .Dq YES ,
-will load the splash screen module, making possible to display a bmp image
+will load the splash screen module, making it possible to display a bmp image
 on the screen while booting.
 .It Va splash_pcx_load
 .Pq Dq NO
 If set to
 .Dq YES ,
-will load the splash screen module, making possible to display a pcx image
+will load the splash screen module, making it possible to display a pcx image
 on the screen while booting.
 .It Va userconfig_script_load
 .Pq Dq NO
--- loader.conf.5.diff ends here ---


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: trhodes 
State-Changed-When: Mon Aug 26 18:03:47 PDT 2002 
State-Changed-Why:  
Not all of this patch applied, which is fine as the current line looks even 
better than before.  I'll MFC this soon.  Thanks for your submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40237 
Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Aug 26 18:05:02 PDT 2002 
Responsible-Changed-Why:  
Over to me for the MFC. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40237 
State-Changed-From-To: patched->closed 
State-Changed-By: trhodes 
State-Changed-When: Tue Aug 27 09:42:21 PDT 2002 
State-Changed-Why:  
Applied to STABLE.  Thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=40237 
>Unformatted:
 	
