[src/trunk]: src/share/man/man8/man8.macppc Make it clear that it's Apple Com...

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

details:   https://anonhg.NetBSD.org/src/rev/336feabd6ca1
branches:  trunk
changeset: 565082:336feabd6ca1
user:      fair <fair%NetBSD.org@localhost>
date:      Mon Mar 29 02:20:51 2004 +0000

description:
Make it clear that it's Apple Computer's OF implementation that
has issues, not OF iself.

New sentence, new line. Macroize some things. Bump date.

This should close PR 21372

diffstat:

 share/man/man8/man8.macppc/boot.8 |  75 ++++++++++++++++++++++++++------------
 1 files changed, 51 insertions(+), 24 deletions(-)

diffs (178 lines):

diff -r 3bc8115ac6ea -r 336feabd6ca1 share/man/man8/man8.macppc/boot.8
--- a/share/man/man8/man8.macppc/boot.8 Mon Mar 29 02:17:26 2004 +0000
+++ b/share/man/man8/man8.macppc/boot.8 Mon Mar 29 02:20:51 2004 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: boot.8,v 1.3 2003/11/14 17:18:18 keihan Exp $
+.\" $NetBSD: boot.8,v 1.4 2004/03/29 02:20:51 fair Exp $
 .\"
 .\" Copyright (c) 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
 .\"
-.Dd June 21, 2003
+.Dd March 28, 2004
 .Dt BOOT 8 macppc
 .Os
 .Sh NAME
@@ -49,10 +49,12 @@
 and unless this fails, the system will resume multi-user operations.
 .Ss Cold starts
 The boot ROM performs a Power On Self Test (POST) then loads Open
-Firmware.  Depending on the Open Firmware variable
+Firmware.
+Depending on the Open Firmware variable
 .Sq Ev auto-boot?
 it will either stop at the Open Firmware
-prompt or attempt to boot an operating system.  Depending on the contents
+prompt or attempt to boot an operating system.
+Depending on the contents
 of the
 .Sq Ev use-nvramrc? ,
 .Sq Ev boot-command ,
@@ -73,7 +75,8 @@
 .Sq Ev boot-device .
 The bootloader then loads the kernel from the
 .Sq Ev boot-file ,
-(if it exists).  Otherwise, it tries to load (in the following order):
+.Pq if it exists .
+Otherwise, it tries to load (in the following order):
 .Pa netbsd , netbsd.gz ,
 or
 .Pa netbsd.macppc
@@ -107,13 +110,15 @@
 .Sq Ev use-nvramrc?
 and
 .Sq Ev auto-boot?
-variables.  If
+variables.
+If
 .Sq Ev use-nvramrc?
 is set to
 .Sq Ev true ,
 then the system will attempt to execute the commands stored in the
 .Sq Ev nvramrc
-variable.  If
+variable.
+If
 .Sq Ev auto-boot?
 is set to
 .Sq Ev true ,
@@ -122,7 +127,8 @@
 .Sq Ev boot-device ,
 and
 .Sq Ev boot-file
-to boot the system.  If
+to boot the system.
+If
 .Sq Ev auto-boot?
 is set to
 .Sq Ev false ,
@@ -204,45 +210,64 @@
 .Li 600000 .
 .Pp
 .It Ev boot-command
-The command to use for booting.  Typically, the default of
+The command to use for booting.
+Typically, the default of
 .Sq Ev boot
 is used.
 .Pp
 .It Ev boot-device
-Device from which to load primary bootloader.  Value depends on a variety
-of factors.  See
+Device from which to load primary bootloader.
+Value depends on a variety of factors.
+See
 .Xr ofwboot 8 .
 .It Ev boot-file
-Kernel location.  Value depends on a variety of factors.  See
+Kernel location.
+Value depends on a variety of factors.
+See
 .Xr ofwboot 8 .
 .Pp
 .It Ev input-device
-What type of console input device (ADB keyboard, USB keyboard, or serial
-port).
+What type of console input device
+.Po
+.Tn ADB
+keyboard,
+.Tn USB
+keyboard, or serial port
+.Pc .
 .Bl -tag -width ttya
 .It Ar kbd
-ADB keyboard on models with ADB, USB keyboard on models with USB, and
-built-in keyboard on laptops.  This is the default on some Open Firmware
+.Tn ADB
+keyboard on models with
+.Tn ADB ,
+.Tn USB
+keyboard on models with
+.Tn USB ,
+and built-in keyboard on laptops.
+This is the default on some Open Firmware
 2.0.x machines and all Open Firmware 2.4 and 3 machines.
 .It Ar ttya
 .Sq Modem
-serial port on machines with serial ports.  Properties are 38400 bps, 8
-bits, no parity, 1 stop bit, no handshaking.  This is the default on all
+serial port on machines with serial ports.
+Properties are 38400 bps, 8 bits, no parity, 1 stop bit, no handshaking.
+This is the default on all
 Open Firmware 1.0.5 systems and some Open Firmware 2.0.x systems.
 .It Ar ttyb
 .Sq Printer
-serial port on machines with serial ports.  Properties are the same as the
+serial port on machines with serial ports.
+Properties are the same as the
 .Sq Modem
 port.
 .It Ar scca
-Serial port on Xserve models.  Properties are 57600 bps, 8 bits, no
+Serial port on Xserve models.
+Properties are 57600 bps, 8 bits, no
 parity, 1 stop bit, no handshaking.
 .El
 .Pp
 .It output-device
 What type of console output device (On-board video, AGP video, PCI video,
 built-in LCD, or serial console).
-Value depends on a variety of factors.  See
+Value depends on a variety of factors.
+See
 .Xr ofwboot 8
 and
 .Lk http://www.NetBSD.org/Ports/macppc/faq.html#ofw-input-output-devices
@@ -351,6 +376,7 @@
 .El
 .Sh SEE ALSO
 .Xr ddb 4 ,
+.Xr intro 4 ,
 .Xr diskless 8 ,
 .Xr halt 8 ,
 .Xr init 8 ,
@@ -372,7 +398,8 @@
 .Nx Ns Tn /macppc
 and Open Firmware often have no relation to each other.
 .Pp
-Open Firmware is easily confused.  It is best to reboot your computer
+Apple Computer's Open Firmware implementation is easily confused.
+It is best to reboot your computer
 after a failed boot attempt,
 .Ic halt ,
 or
@@ -381,8 +408,8 @@
 .Ic reset-all
 command.
 .Pp
-Open Firmware is notoriously bad.  Thorough instructions for installing
-and booting
+Apple Computer's Open Firmware implementation is notoriously bad.
+Thorough instructions for installing and booting
 .Nx
 are in the install notes
 .Pq Pa INSTALL.html