[src/trunk]: src/share/man/man8/man8.sparc More mdoc; some grammar fixes; com...

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

details:   https://anonhg.NetBSD.org/src/rev/74ac511e49fa
branches:  trunk
changeset: 546457:74ac511e49fa
user:      wiz <wiz%NetBSD.org@localhost>
date:      Tue Apr 29 13:13:10 2003 +0000

description:
More mdoc; some grammar fixes; comment out Xref to crash(8) (doesn't exist).

diffstat:

 share/man/man8/man8.sparc/boot.8 |  65 +++++++++++++++++++++++++++------------
 1 files changed, 44 insertions(+), 21 deletions(-)

diffs (120 lines):

diff -r dd291b2535f0 -r 74ac511e49fa share/man/man8/man8.sparc/boot.8
--- a/share/man/man8/man8.sparc/boot.8  Tue Apr 29 13:05:32 2003 +0000
+++ b/share/man/man8/man8.sparc/boot.8  Tue Apr 29 13:13:10 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: boot.8,v 1.21 2003/04/08 07:58:56 wiz Exp $
+.\"    $NetBSD: boot.8,v 1.22 2003/04/29 13:13:10 wiz Exp $
 .\"
 .\" Copyright (c) 1992, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -44,14 +44,15 @@
 .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 +60,9 @@
 boot
 .Pa netbsd
 from partition a of the boot device,
-which must currently be an ``sd'' disk.
+which must currently be an
+.Dq sd
+disk.
 .Ss Boot program options
 .Bl -tag -width xxx
 .It Fl a
@@ -79,36 +82,56 @@
 .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
-The SPARC boot ROM comes in two flavours: an ``old-style'' ROM is used in
-sun4 machines, while A ``new-style'' ROM can be found on sun4c and sun4m models.
-The ``new-style'' SPARC boot ROM is a full-featured Forth system with emacs
-key bindings. It can be put in ``old-style'' user-interface compatibility
-mode (in which case it shows a simple `\*[Gt]' prompt), but this is essentially
-useless. However, by default the ROM runs in old-mode; to enter new-mode type `n'.
-The ROM then shows a Forth-style `ok' prompt. It is recommended to have
-the ROM always start in its native ``new-style'' mode. Utter the following
-incantation in new-mode to force the ROM to always start in new-mode.
+The SPARC boot ROM comes in two flavours: an
+.Dq old-style
+ROM is used in sun4 machines, while a
+.Dq new-style
+ROM can be found on sun4c and sun4m models.
+The
+.Dq new-style
+SPARC boot ROM is a full-featured Forth system with emacs key bindings.
+It can be put in
+.Dq old-style
+user-interface compatibility mode (in which case it shows a simple
+.Sq \*[Gt]
+prompt), but this is essentially useless.
+However, by default the ROM runs in old-mode; to enter new-mode type
+.Sq n .
+The ROM then shows a Forth-style
+.Dq ok
+prompt.
+It is recommended to have the ROM always start in its native
+.Dq new-style
+mode.
+Utter the following incantation in new-mode to force the ROM to always start
+in new-mode.
 .Pp
 .Pa \  ok
 setenv sunmon-compat? false
 .Pp
-The ROM will normally load the kernel from "sd(0,0,0)vmunix". To change the
-default so that
+The ROM will normally load the kernel from
+.Dq sd(0,0,0)vmunix .
+To change the default so that
 .Nx
-will be loaded type the following
+will be loaded from somewhere else, type the following
 .Pp
 .Pa \  ok
 setenv boot-from sd(0,0,0)netbsd
 .Pp
-At any time you can break back to the ROM by pressing the `L1' and `a'
+At any time you can break back to the ROM by pressing the
+.Sq L1
+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 FILES
 .Bl -tag -width /netbsdxx -compact
 .It Pa /netbsd
@@ -117,7 +140,7 @@
 system bootstrap
 .El
 .Sh SEE ALSO
-.Xr crash 8 ,
+.\" .Xr crash 8 ,
 .Xr disklabel 8 ,
 .Xr fsck 8 ,
 .Xr halt 8 ,