- section reorder

- new sentence, new line
- some macro fixes

11 files changed, 138 insertions, 131 deletions

diff --git a/sys/arch/alpha/stand/installboot.8 b/sys/arch/alpha/stand/installboot.8
index e23868e195c..343f577d08d 100644
--- a/sys/arch/alpha/stand/installboot.8
+++ b/sys/arch/alpha/stand/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.7 2000/01/03 20:04:27 pjanzen Exp $
+.\"	$OpenBSD: installboot.8,v 1.8 2003/06/06 21:45:33 jmc Exp $
 .\"	$NetBSD: installboot.8,v 1.2 1997/04/06 08:41:11 cgd Exp $
 .\"
 .\" Copyright (c) 1996, 1997 Christopher G. Demetriou.  All rights reserved.
@@ -59,9 +59,9 @@ typically with the name
 .Pa /boot
 .Pc .
 The first-stage boot program is loaded into memory by the SRM console
-software.  After receiving control of the system, it loads the
-second-stage boot program from a set of filesystem block numbers that
-have been
+software.
+After receiving control of the system, it loads the second-stage boot
+program from a set of filesystem block numbers that have been
 hard-coded into it by
 .Nm installboot .
 The second-stage boot program locates and loads the kernel.
@@ -112,12 +112,21 @@ you would install the first-stage boot program on the disk
 .Bd -literal -offset indent
 installboot /boot /usr/mdec/bootxx /dev/rsd0c
 .Ed
+.Sh SEE ALSO
+.Xr disklabel 8 ,
+.Xr init 8 ,
+.Xr sysctl 8
+.Sh HISTORY
+The alpha
+.Nm
+command first appeared in
+.Nx 1.2 .
 .Sh BUGS
 The OpenBSD/alpha boot blocks can only load kernels from disks'
 .Dq a
-partitions.  (However, the second-stage boot
-program may be located on any FFS file system partition
-on the disk.)
+partitions.
+(However, the second-stage boot program may be located on any FFS file system
+partition on the disk.)
 .Pp
 .Nm Installboot
 requires simultaneous access to the mounted file system and
@@ -134,12 +143,3 @@ set to a value greater than one, or with
 set to one if the
 .Dq boot
 program resides in a file system on the disk's raw partition.
-.Sh SEE ALSO
-.Xr disklabel 8 ,
-.Xr init 8 ,
-.Xr sysctl 8
-.Sh HISTORY
-The alpha
-.Nm
-command first appeared in
-.Nx 1.2 .
diff --git a/sys/arch/alpha/stand/setnetbootinfo/setnetbootinfo.8 b/sys/arch/alpha/stand/setnetbootinfo/setnetbootinfo.8
index cbf18169156..33749172eef 100644
--- a/sys/arch/alpha/stand/setnetbootinfo/setnetbootinfo.8
+++ b/sys/arch/alpha/stand/setnetbootinfo/setnetbootinfo.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: setnetbootinfo.8,v 1.4 2000/01/03 20:04:28 pjanzen Exp $
+.\"	$OpenBSD: setnetbootinfo.8,v 1.5 2003/06/06 21:45:33 jmc Exp $
 .\"	$NetBSD: setnetbootinfo.8,v 1.2 1997/04/06 08:41:36 cgd Exp $
 .\"
 .\" Copyright (c) 1997 Christopher G. Demetriou.  All rights reserved.
@@ -82,8 +82,8 @@ program can get address information from the booting system's
 firmware.
 .It Fl h Ar ether-host
 Encode the ethernet address of the specified host into the network
-bootstrap program.  The host's name is translated to an ethernet
-address using the
+bootstrap program.
+The host's name is translated to an ethernet address using the
 .Xr ether_hostton 3
 function.
 (This option and the
@@ -92,7 +92,8 @@ option are mutually exclusive.)
 .It Fl o Ar outfile
 Output the resulting bootstrap program into the file named by
 .Ar outfile ,
-replacing it if it already exists.  If the
+replacing it if it already exists.
+If the
 .Fl o
 flag is not specified, the output file name will be
 the name of the input bootstrap program concatenated with a
@@ -108,8 +109,8 @@ input file name; the input file is read in its entirety before
 the output file is modified.
 .It Fl u
 Remove configuration information from the specified network
-bootstrap program.  If this option is used, an output file name must be
-specified with the
+bootstrap program.
+If this option is used, an output file name must be specified with the
 .Fl o
 option, and neither the
 .Fl a
diff --git a/sys/arch/hppa/stand/boot/boot.8 b/sys/arch/hppa/stand/boot/boot.8
index 28bf06ffd4b..5d7446f9c24 100644
--- a/sys/arch/hppa/stand/boot/boot.8
+++ b/sys/arch/hppa/stand/boot/boot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: boot.8,v 1.6 2003/02/01 16:38:39 jmc Exp $
+.\"	$OpenBSD: boot.8,v 1.7 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 2002 Miodrag Vallat
 .\" Copyright (c) 1997-2002 Michael Shalayeff
@@ -269,6 +269,15 @@ booting the default kernel image.
 .It time
 Displays system time and date.
 .El
+.Sh FILES
+.Bl -tag -width /etc/boot.conf -compact
+.It Pa /boot
+system bootstrap
+.It Pa /etc/boot.conf
+system bootstrap's startup file
+.It Pa /bsd
+kernel image
+.El
 .Sh EXAMPLES
 .Li boot> boot
 .Pp
@@ -301,19 +310,6 @@ Once booted, such changes can be made permanent by using
 .Xr config 8 Ns 's
 .Fl e
 option.
-.Sh BUGS
-.Pp
-Changing the display resolution (mode) on a graphics console does not work
-correctly.
-.Sh FILES
-.Bl -tag -width /etc/boot.conf -compact
-.It Pa /boot
-system bootstrap
-.It Pa /etc/boot.conf
-system bootstrap's startup file
-.It Pa /bsd
-kernel image
-.El
 .Sh SEE ALSO
 .Xr gzip 1 ,
 .Xr autoconf 4 ,
@@ -335,3 +331,6 @@ for
 .Ox 3.1 .
 .Sh CAVEATS
 Making mistakes in console paths may cost you a toupee.
+.Sh BUGS
+Changing the display resolution (mode) on a graphics console does not work
+correctly.
diff --git a/sys/arch/i386/stand/biosboot/biosboot.8 b/sys/arch/i386/stand/biosboot/biosboot.8
index a52bef0f268..595af1723da 100644
--- a/sys/arch/i386/stand/biosboot/biosboot.8
+++ b/sys/arch/i386/stand/biosboot/biosboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: biosboot.8,v 1.16 2003/06/03 20:22:11 mickey Exp $
+.\"	$OpenBSD: biosboot.8,v 1.17 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 1997 Michael Shalayeff
 .\" All rights reserved.
@@ -47,7 +47,8 @@ location.
 .Nm
 must be installed by, and have its block table filled in by, the
 .Xr installboot 8
-program.  As this data is BIOS dependent, you must re-run
+program.
+As this data is BIOS dependent, you must re-run
 .Xr installboot 8
 each time you reinstall
 .Xr boot 8
@@ -66,12 +67,12 @@ protected mode and transferring control to the just loaded /boot program.
 Diagnostics consist of two error messages:
 .Bl -tag -width read_error_
 .It Er Read error
-Some kind of error returned by the BIOS read call. This might be
-any media error, including bad sectors (common on floppy disks),
+Some kind of error returned by the BIOS read call.
+This might be any media error, including bad sectors (common on floppy disks),
 and invalid sectors (can occur with messed up geometry translations).
 .It Er Bad magic
-The just loaded /boot image contains a bad magic in its header.  This
-might indicate some kind of hardware problem, the
+The just loaded /boot image contains a bad magic in its header.
+This might indicate some kind of hardware problem, the
 .Ar boot
 argument to the
 .Xr installboot 8
@@ -84,14 +85,17 @@ has been used in
 .Xr installboot 8
 for the device you are booting from.
 .Sh NOTES
-The practice of making OpenBSD use the whole disk (ie: having
+The practice of making
+.Ox
+use the whole disk (ie: having
 .Nm
 as the MBR) has been deprecated, and will not work on certain BIOS versions.
 There is a lot of strange behaviour with different BIOSes; one well
 known lobotomy case is that the BIOS does not pass the right boot drive
 number to the
 .Nm
-program.  This is one of the main reasons that having
+program.
+This is one of the main reasons that having
 .Nm
 as the MBR has been deprecated.
 .Sh FILES
@@ -110,6 +114,12 @@ system code
 .Xr boot_i386 8 ,
 .Xr fdisk 8 ,
 .Xr installboot 8
+.Sh HISTORY
+This program was written by Michael Shalayeff for
+.Ox 2.1 .
+However it's based on bootstrap code from older versions of this
+operating system, other operating systems, other programs, and
+other people's work.
 .Sh BUGS
 It should do a checksum over the loaded /boot image, and check that against
 a value that
@@ -121,9 +131,3 @@ reported.
 .Pp
 You can pick your motherboard, and you can pick your BIOS,
 but you can't pick your motherboard's BIOS.
-.Sh HISTORY
-This program was written by Michael Shalayeff for
-.Ox 2.1 .
-However it's based on bootstrap code from older versions of this
-operating system, other operating systems, other programs, and
-other people's work.
diff --git a/sys/arch/i386/stand/boot/boot.8 b/sys/arch/i386/stand/boot/boot.8
index 13e19d72417..6402645465c 100644
--- a/sys/arch/i386/stand/boot/boot.8
+++ b/sys/arch/i386/stand/boot/boot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: boot.8,v 1.32 2003/06/03 20:22:11 mickey Exp $
+.\"	$OpenBSD: boot.8,v 1.33 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 1997-2001 Michael Shalayeff
 .\" All rights reserved.
@@ -276,6 +276,17 @@ The default baudrate is 9600bps.
 .It time
 Displays system time and date.
 .El
+.Sh FILES
+.Bl -tag -width /usr/mdec/biosbootxx -compact
+.It Pa /usr/mdec/biosboot
+first stage bootstrap
+.It Pa /boot
+system bootstrap
+.It Pa /etc/boot.conf
+system bootstrap's startup file
+.It Pa /bsd
+kernel image
+.El
 .Sh EXAMPLES
 .Li boot> boot
 .Pp
@@ -312,17 +323,6 @@ Once booted, such changes can be made permanent by using
 .Xr config 8 Ns 's
 .Fl e
 option.
-.Sh FILES
-.Bl -tag -width /usr/mdec/biosbootxx -compact
-.It Pa /usr/mdec/biosboot
-first stage bootstrap
-.It Pa /boot
-system bootstrap
-.It Pa /etc/boot.conf
-system bootstrap's startup file
-.It Pa /bsd
-kernel image
-.El
 .Sh SEE ALSO
 .Xr gzip 1 ,
 .Xr autoconf 4 ,
diff --git a/sys/arch/i386/stand/installboot/installboot.8 b/sys/arch/i386/stand/installboot/installboot.8
index 44dd3d554e1..f107578d472 100644
--- a/sys/arch/i386/stand/installboot/installboot.8
+++ b/sys/arch/i386/stand/installboot/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.25 2003/06/03 20:22:11 mickey Exp $
+.\"	$OpenBSD: installboot.8,v 1.26 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 1997 Michael Shalayeff
 .\" All rights reserved.
@@ -82,8 +82,8 @@ The arguments are:
 .Bl -tag -width biosboot
 .It Ar boot
 The name of the second-stage boot program in the mounted file system
-where the first-stage boot program is to be installed.  This should be
-a full pathname.
+where the first-stage boot program is to be installed.
+This should be a full pathname.
 .It Ar biosboot
 The name of the prototype file for the first stage boot program,
 usually
@@ -122,7 +122,8 @@ The typical use is
 .Pp
 And if the information supplied looks right, run the above without the
 .Fl n
-flag.  If you are upgrading an old system, you may need to preface
+flag.
+If you are upgrading an old system, you may need to preface
 the above steps with some more steps... and do the following:
 .Pp
 .Dl boot the floppy.fs filesystem floppy
@@ -138,6 +139,11 @@ and
 you can use the boot block command:
 .Pp
 .Dl boot> machine diskinfo
+.Sh SEE ALSO
+.Xr biosboot 8 ,
+.Xr disklabel 8 ,
+.Xr fdisk 8 ,
+.Xr init 8
 .Sh BUGS
 The disklabel
 .Va d_type
@@ -149,8 +155,3 @@ You cannot run
 for a drive/partition other than the one you want the
 .Pa /boot
 to be loaded from.
-.Sh SEE ALSO
-.Xr biosboot 8 ,
-.Xr disklabel 8 ,
-.Xr fdisk 8 ,
-.Xr init 8
diff --git a/sys/arch/mvme68k/stand/installboot/installboot.8 b/sys/arch/mvme68k/stand/installboot/installboot.8
index 021925a8c90..6f4565f0349 100644
--- a/sys/arch/mvme68k/stand/installboot/installboot.8
+++ b/sys/arch/mvme68k/stand/installboot/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.13 2003/05/08 08:53:23 jmc Exp $
+.\"	$OpenBSD: installboot.8,v 1.14 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 1994 Paul Kranenburg
 .\" All rights reserved.
@@ -78,6 +78,9 @@ is mounted.
 cp /usr/mdec/bootsd /
 /usr/mdec/installboot /bootsd /usr/mdec/bootxx /dev/rsd0a
 .Ed
+.Sh SEE ALSO
+.Xr disklabel 8 ,
+.Xr init 8
 .Sh BUGS
 .Nm installboot
 requires simultaneous access to the mounted file system and
@@ -86,7 +89,4 @@ the raw device, but that is not allowed with the kernel
 variable set to a value greater than zero (the default), so
 .Nm installboot
 only works in single-user mode (or insecure mode - see
-.Xr init 8 ).
-.Sh SEE ALSO
-.Xr disklabel 8 ,
-.Xr init 8
+.Xr init 8 ) .
diff --git a/sys/arch/mvme88k/stand/installboot/installboot.8 b/sys/arch/mvme88k/stand/installboot/installboot.8
index aee477e6388..038d5f144f6 100644
--- a/sys/arch/mvme88k/stand/installboot/installboot.8
+++ b/sys/arch/mvme88k/stand/installboot/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.10 2003/05/08 08:53:23 jmc Exp $
+.\"	$OpenBSD: installboot.8,v 1.11 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 1994 Paul Kranenburg
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-.\" 
+.\"
 .Dd May 31, 1995
 .Dt INSTALLBOOT 8 mvme88k
 .Os
@@ -68,8 +68,8 @@ where the first-stage boot program is to be installed.
 the name of the prototype file for the first stage boot program.
 .It Ar rawdev
 the name of the raw device in which the first-stage boot program
-is to be installed.  This should correspond to the block device
-on which the file system containing
+is to be installed.
+This should correspond to the block device on which the file system containing
 .Ar ufsboot
 is mounted.
 .El
@@ -79,6 +79,9 @@ cd /usr/mdec
 cp bootsd /
 installboot -v /bootsd ./bootxx /dev/rsd0a
 .Ed
+.Sh SEE ALSO
+.Xr disklabel 8 ,
+.Xr init 8
 .Sh BUGS
 .Nm installboot
 requires simultaneous access to the mounted file system and
@@ -87,7 +90,4 @@ the raw device, but that is not allowed with the kernel
 variable set to a value greater than zero (the default), so
 .Nm installboot
 only works in single-user mode (or insecure mode - see
-.Xr init 8 ).
-.Sh SEE ALSO
-.Xr disklabel 8 ,
-.Xr init 8
+.Xr init 8 ) .
diff --git a/sys/arch/mvmeppc/stand/installboot/installboot.8 b/sys/arch/mvmeppc/stand/installboot/installboot.8
index 318ad6de21b..6131bc55fc9 100644
--- a/sys/arch/mvmeppc/stand/installboot/installboot.8
+++ b/sys/arch/mvmeppc/stand/installboot/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.4 2003/05/08 08:53:23 jmc Exp $
+.\"	$OpenBSD: installboot.8,v 1.5 2003/06/06 21:45:33 jmc Exp $
 .\"
 .\" Copyright (c) 1994 Paul Kranenburg
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-.\" 
+.\"
 .Dd May 31, 1995
 .Dt INSTALLBOOT 8 mvme88k
 .Os
@@ -68,8 +68,8 @@ where the first-stage boot program is to be installed.
 the name of the prototype file for the first stage boot program.
 .It Ar rawdev
 the name of the raw device in which the first-stage boot program
-is to be installed.  This should correspond to the block device
-on which the file system containing
+is to be installed.
+This should correspond to the block device on which the file system containing
 .Ar ufsboot
 is mounted.
 .El
@@ -79,6 +79,9 @@ cd /usr/mdec
 cp bootsd /
 installboot -v /bootsd ./bootxx /dev/rsd0a
 .Ed
+.Sh SEE ALSO
+.Xr disklabel 8 ,
+.Xr init 8
 .Sh BUGS
 .Nm installboot
 requires simultaneous access to the mounted file system and
@@ -87,7 +90,4 @@ the raw device, but that is not allowed with the kernel
 variable set to a value greater than zero (the default), so
 .Nm installboot
 only works in single-user mode (or insecure mode - see
-.Xr init 8 ).
-.Sh SEE ALSO
-.Xr disklabel 8 ,
-.Xr init 8
+.Xr init 8 ) .
diff --git a/sys/arch/sparc/stand/installboot/installboot.8 b/sys/arch/sparc/stand/installboot/installboot.8
index aa6fb3cacb1..2448cb74bdc 100644
--- a/sys/arch/sparc/stand/installboot/installboot.8
+++ b/sys/arch/sparc/stand/installboot/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.7 2003/02/07 07:45:12 jmc Exp $
+.\"	$OpenBSD: installboot.8,v 1.8 2003/06/06 21:45:33 jmc Exp $
 .\"	$NetBSD: installboot.8,v 1.1 1995/09/30 21:32:14 pk Exp $
 .\"
 .\" Copyright (c) 1995 Paul Kranenburg
@@ -51,11 +51,12 @@ is written into the superblock area in a partition
 and hence is limited in size to SBSIZE - DEV_BSIZE bytes
 .Pc ,
 and a second-stage program that resides in the filesystem proper.
-The first-stage program is loaded into memory by the PROM. After it receives
-control, it loads the second stage program from a set of filesystem block
-numbers that have been hard-coded into it by the
+The first-stage program is loaded into memory by the PROM.
+After it receives control, it loads the second stage program from a set of
+filesystem block numbers that have been hard-coded into it by the
 .Nm installboot
-program. The second-stage boot program uses the device driver interface to
+program.
+The second-stage boot program uses the device driver interface to
 the PROM and the stand-alone filesystem code in
 .Dq libsa.a
 to locate and load the kernel.
@@ -64,21 +65,21 @@ first-stage bootprogram can be found in
 .Pa /usr/mdec/boot
 and
 .Pa /usr/mdec/bootxx
-respectively. The second-stage program commonly resides in the root directory
-as
+respectively.
+The second-stage program commonly resides in the root directory as
 .Pa /boot .
 The utility
 .Pa /usr/mdec/binstall
-can be used to properly copy the second-stage bootprogram to its
-destination. This script takes care of post-processing that is required
-on
+can be used to properly copy the second-stage bootprogram to its destination.
+This script takes care of post-processing that is required on
 .Pf non- Tn Openboot
 machines.
 .Pp
 The options are as follows:
 .Bl -tag -width flag
 .It Fl a Ar karch
-Set the machine architecture. The argument
+Set the machine architecture.
+The argument
 .Ar karch
 can be one of
 .Dq sun4 ,
@@ -89,8 +90,8 @@ Sun 4c models with
 .Tn Openboot
 PROMs need the header to be present, while Sun 4 systems with the
 .Dq old monitor
-interface require the header to be stripped off. This is normally taken
-care of by
+interface require the header to be stripped off.
+This is normally taken care of by
 .Nm installboot
 automatically, but it's useful when preparing a bootable filesystem for
 another system.
@@ -99,7 +100,8 @@ Leave the
 .Xr a.out 5
 header on the installed
 .Ar bootxx
-program. This option has been superseded by the
+program.
+This option has been superseded by the
 .Fl a Ar karch
 option.
 .It Fl n
@@ -117,8 +119,8 @@ where the first-stage boot program is to be installed.
 the name of the prototype file for the first stage boot program.
 .It Ar device
 the name of the raw device in which the first-stage boot program
-is to be installed.  This should correspond to the block device
-on which the file system containing
+is to be installed.
+This should correspond to the block device on which the file system containing
 .Ar boot
 is mounted.
 .El
@@ -132,6 +134,14 @@ as the second-level boot program:
 .Bd -literal -offset indent
 installboot /boot /usr/mdec/bootxx /dev/rsd0a
 .Ed
+.Sh SEE ALSO
+.Xr disklabel 8 ,
+.Xr init 8
+.Sh HISTORY
+The
+.Nm installboot
+first appeared in
+.Nx 1.1 .
 .Sh BUGS
 .Nm installboot
 requires simultaneous access to the mounted file system and
@@ -143,11 +153,3 @@ so
 .Nm installboot
 only works in single-user mode
 .Pq or insecure mode - see Xr init 8 .
-.Sh SEE ALSO
-.Xr disklabel 8 ,
-.Xr init 8
-.Sh HISTORY
-The
-.Nm installboot
-first appeared in
-.Nx 1.1 .
diff --git a/sys/arch/sparc64/stand/installboot/installboot.8 b/sys/arch/sparc64/stand/installboot/installboot.8
index 01e15fc4868..c57a8bf99b6 100644
--- a/sys/arch/sparc64/stand/installboot/installboot.8
+++ b/sys/arch/sparc64/stand/installboot/installboot.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: installboot.8,v 1.4 2003/02/07 07:45:13 jmc Exp $
+.\"	$OpenBSD: installboot.8,v 1.5 2003/06/06 21:45:33 jmc Exp $
 .\"	$NetBSD: installboot.8,v 1.1 1995/09/30 21:32:14 pk Exp $
 .\"
 .\" Copyright (c) 1995 Paul Kranenburg
@@ -49,8 +49,8 @@ is written into the superblock area in a partition
 and hence is limited in size to SBSIZE - DEV_BSIZE bytes
 .Pc ,
 and a second-stage program that resides in the filesystem proper.
-The first-stage program is loaded into memory by the PROM. After it receives
-control, it loads the second stage program
+The first-stage program is loaded into memory by the PROM.
+After it receives control, it loads the second stage program
 .Ar ofwboot
 from the filesystem.
 The second-stage boot program uses the device driver interface to
@@ -62,8 +62,8 @@ first-stage bootprogram can be found in
 .Pa /usr/mdec/ofwboot
 and
 .Pa /usr/mdec/bootblk
-respectively. The second-stage program commonly resides in the root directory
-as
+respectively.
+The second-stage program commonly resides in the root directory as
 .Pa /ofwboot .
 .Pp
 The options are as follows:
@@ -80,8 +80,8 @@ The arguments are:
 the name of the prototype file for the first stage boot program.
 .It Ar device
 the name of the raw device in which the first-stage boot program
-is to be installed.  This should correspond to the block device
-on which the file system containing
+is to be installed.
+This should correspond to the block device on which the file system containing
 .Ar ofwboot
 is mounted.
 .El
@@ -95,6 +95,14 @@ as the second-level boot program:
 .Bd -literal -offset indent
 installboot /usr/mdec/bootblk /dev/rsd0a
 .Ed
+.Sh SEE ALSO
+.Xr disklabel 8 ,
+.Xr init 8
+.Sh HISTORY
+The
+.Nm installboot
+first appeared in
+.Nx 1.1 .
 .Sh BUGS
 .Nm installboot
 requires simultaneous access to the mounted file system and
@@ -106,11 +114,3 @@ so
 .Nm installboot
 only works in single-user mode
 .Pq or insecure mode - see Xr init 8 .
-.Sh SEE ALSO
-.Xr disklabel 8 ,
-.Xr init 8
-.Sh HISTORY
-The
-.Nm installboot
-first appeared in
-.Nx 1.1 .