[src/trunk]: src/share/man/man8/man8.sparc filesystem -> file system; add `.'...

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/cdebf6957332
branches:  trunk
changeset: 518095:cdebf6957332
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sat Nov 24 07:40:22 2001 +0000

description:
filesystem -> file system; add `.' at end of HISTORY section; sort sections;
don't use Pc/Po/Pq; drop Nm arguments in most places (because they're not
needed); update Dd for mrg's changes today.

diffstat:

 share/man/man8/man8.sparc/installboot.8 |  92 ++++++++++++++++----------------
 1 files changed, 45 insertions(+), 47 deletions(-)

diffs (152 lines):

diff -r 958fced50719 -r cdebf6957332 share/man/man8/man8.sparc/installboot.8
--- a/share/man/man8/man8.sparc/installboot.8   Sat Nov 24 06:53:16 2001 +0000
+++ b/share/man/man8/man8.sparc/installboot.8   Sat Nov 24 07:40:22 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: installboot.8,v 1.11 2001/11/24 01:52:02 mrg Exp $
+.\"    $NetBSD: installboot.8,v 1.12 2001/11/24 07:40:22 wiz Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,12 +34,12 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 29, 1995
+.Dd November 24, 2001
 .Dt INSTALLBOOT 8 sparc
 .Os
 .Sh NAME
 .Nm installboot
-.Nd install a bootstrap on an FFS filesystem partition
+.Nd install a bootstrap on an FFS file system partition
 .Sh SYNOPSIS
 .Nm installboot
 .Op Fl U
@@ -53,24 +53,22 @@
 .Ar bootblk
 .Ar device
 .Sh DESCRIPTION
-.Nm installboot
-prepares a FFS filesystem partition for boot-strapping from the PROM.
+.Nm
+prepares a FFS file system partition for boot-strapping from the PROM.
 The sparc bootblocks are split into two parts: a small first-stage program that
 is written into the superblock area in a partition
-.Po
-and hence is limited in size to SBSIZE - DEV_BSIZE bytes
-.Pc ,
-and a second-stage program that resides in the filesystem proper.
+(and hence is limited in size to SBSIZE - DEV_BSIZE bytes),
+and a second-stage program that resides in the file system proper.
 .Pp
 The first-stage program is loaded into memory by the PROM. After it receiving
-control, it loads the second stage program from a set of filesystem block
+control, it loads the second stage program from a set of file system block
 numbers that have been hard-coded into it by the
-.Nm installboot
+.Nm
 program, or, on the UltraSPARC, finds the second stage boot program by a
-name lookup in the filesystem.
+name lookup in the file system.
 .Pp
 The second-stage boot program uses the device driver interface to
-the PROM and the stand-alone filesystem code in
+the PROM and the stand-alone file system code in
 .Dq libsa.a
 to locate and load the kernel.
 For non-UltraSPARC machines,
@@ -111,9 +109,7 @@
 enough of the magic numbers in it to appease
 .Tn Openboot
 ROMs, while simultaneously consisting of instructions
-.Po
-in fact, just a branch past the rest of the header
-.Pc
+(in fact, just a branch past the rest of the header)
 for Sun 4
 .Dq old monitor
 ROMs to execute.  On the UltraSPARC machines, the first stage loader
@@ -158,10 +154,28 @@
 the name of the raw device in which the first-stage boot program
 is to be installed.
 .El
+.Sh FILES
+.Bl -tag -width /usr/mdec/installboot -compact
+.It Pa /usr/mdec/installboot
+program to install first-stage boot blocks
+.It Pa /usr/mdec/binstall
+front-end script to installing boot blocks
+.It Pa /usr/mdec/bootxx
+SPARC first-stage boot block
+.It Pa /usr/mdec/bootblk
+UltraSPARC first-stage boot block
+.It Pa /usr/mdec/boot
+SPARC second-stage boot block
+.It Pa /usr/mdec/ofwboot
+UltraSPARC second-stage boot block
+.It Pa /usr/mdec/ofwboot.net
+UltraSPARC second-stage network boot block
+.El
 .Sh EXAMPLES
 The following command will install the first-stage bootblocks in the
-root filesystem of a SPARC
-.Pq assumed to be mounted on Dq sd0a
+root file system of a SPARC
+(assumed to be mounted on
+.Dq sd0a )
 using the file
 .Pa /boot
 as the second-level boot program:
@@ -179,34 +193,6 @@
 .Bd -literal -offset indent
 /usr/mdec/installboot -U /boot /usr/mdec/bootxx /dev/rsd0a
 .Ed
-.Sh BUGS
-.Nm
-requires simultaneous access to the mounted file system and
-the raw device, but that is not allowed with the kernel
-.Dv securelevel
-variable set to a value greater than zero
-.Pq the default ,
-so
-.Nm installboot
-only works in single-user mode
-.Pq or insecure mode - see Xr init 8 .
-.Sh FILES
-.Bl -tag -width /usr/mdec/installboot -compact
-.It Pa /usr/mdec/installboot
-program to install first-stage boot blocks
-.It Pa /usr/mdec/binstall
-front-end script to installing boot blocks
-.It Pa /usr/mdec/bootxx
-SPARC first-stage boot block
-.It Pa /usr/mdec/bootblk
-UltraSPARC first-stage boot block
-.It Pa /usr/mdec/boot
-SPARC second-stage boot block
-.It Pa /usr/mdec/ofwboot
-UltraSPARC second-stage boot block
-.It Pa /usr/mdec/ofwboot.net
-UltraSPARC second-stage network boot block
-.El
 .Sh SEE ALSO
 .Xr disklabel 8 ,
 .Xr init 8
@@ -214,4 +200,16 @@
 The
 .Nm
 first appeared in
-.Nx 1.1
+.Nx 1.1 .
+.Sh BUGS
+.Nm
+requires simultaneous access to the mounted file system and
+the raw device, but that is not allowed with the kernel
+.Dv securelevel
+variable set to a value greater than zero
+(the default),
+so
+.Nm
+only works in single-user mode
+(or insecure mode - see
+.Xr init 8 ) .