Sort sections; new sentence, new line; use more mdoc;

drop crash(8) reference.

share/man/man8/man8.sparc64/boot.8

@@ -1,4 +1,4 @@
-.\"	$NetBSD: boot.8,v 1.2 2003/04/30 20:40:06 martin Exp $
+.\"	$NetBSD: boot.8,v 1.3 2003/05/01 02:11:01 wiz Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -38,20 +38,20 @@
 .Os
 .Sh NAME
 .Nm boot
-.Nd
-system bootstrapping procedures
+.Nd system bootstrapping procedures
 .Sh SYNOPSIS
 .Nm boot
 .Op Fl adqsv
 .Oo
-.Ar -- \*[Lt]boot string\*[Gt]
+.Ar --
+.Aq Ar boot string
 .Oc
 .Sh DESCRIPTION
 .Ss Power fail and crash recovery
 Normally, the system will reboot itself at power-up or after crashes.
 An automatic consistency check of the file systems will be performed
 as described in
-.Xr fsck 8 .
+.Xr fsck 8 ,
 and unless this fails, the system will resume multi-user operations.
 .Ss Cold starts
 The
@@ -59,7 +59,8 @@ The
 boot
 .Pa netbsd
 from the default boot device, configured via OpenFirmware environment
-variables. See below for details.
+variables.
+See below for details.
 .Ss Boot program options
 .Bl -tag -width xxx
 .It Fl a
@@ -79,24 +80,31 @@ Boot the system in verbose mode.
 .El
 .Pp
 Any extra flags or arguments, or the
-.Ar \*[Lt]boot string\*[Gt]
+.Aq Ar boot string
 after the -- separator are passed to the boot PROM.
 Other flags are currently ignored.
 .Pp
-At any time you can break back to the ROM by pressing the `STOP'
-(labeled `L1' on older keyboard types) and `a'
+At any time you can break back to the ROM by pressing the
+.Sq STOP
+(labeled
+.Sq L1
+on older keyboard types) and
+.Sq a
 keys at the same time (if the console is a serial port the same is
-achieved by sending a `break').
+achieved by sending a
+.Sq break ) .
 If you do this accidentally you can continue whatever was in progress
-by typing `go'.
+by typing
+.Sq go .
 .Sh BOOT DEVICES
 Since machines vary in the way their devices are connected greatly, there
-are aliases defined by the firmware. You can either use the full qualified
-OpenFirmware path of a device node, or the alias.
+are aliases defined by the firmware.
+You can either use the full qualified OpenFirmware path of a device node,
+or the alias.
 .Pp
 A typical list of usable boot devices (extracted from the output of
-the OpenFirmware command 
-.Em devalias )
+the OpenFirmware command
+.Ic devalias )
 is:
 .Bd -literal -offset indent
 net                      /sbus/SUNW,hme@e,8c00000
@@ -120,11 +128,13 @@ The boot device is an optional first part of the boot string, if no device
 is specified the default device is used (see below).
 .Sh FIRMWARE ENVIRONMENT VARIABLES
 All OpenFirmware environment variables can be printed with the
-.Em printenv
+.Ic printenv
 command and changed with
-.Em setenv .
+.Ic setenv .
 The boot process relevant variables and their suggested value for
-booting NetBSD are:
+booting
+.Nx
+are:
 .Bd -literal -offset indent
 boot-command          boot
 auto-boot?            true
@@ -137,11 +147,19 @@ Of course you may select any other boot device, if you do not want to boot
 from the device aliased to
 .Em disk ,
 see the discussion on devices above.
+.Sh FILES
+.Bl -tag -width /netbsdxx -compact
+.It Pa /netbsd
+system code
+.It Pa /boot
+system bootstrap
+.El
 .Sh EXAMPLES
 .Bd -literal -offset indent
 boot cdrom
 .Ed
-Boot from CDROM. Note that some multi-arch CDs are not able to use the
+Boot from CDROM.
+Note that some multi-arch CDs are not able to use the
 default sparc64 partition for CDROMs (f), so they may require an explicit
 partition letter, for example
 .Bd -literal -offset indent
@@ -153,15 +171,7 @@ boot net -sd
 .Ed
 to boot single user from network and break into the kernel debugger as
 soon as possible.
-.Sh FILES
-.Bl -tag -width /netbsdxx -compact
-.It Pa /netbsd
-system code
-.It Pa /boot
-system bootstrap
-.El
 .Sh SEE ALSO
-.Xr crash 8 ,
 .Xr disklabel 8 ,
 .Xr fsck 8 ,
 .Xr halt 8 ,