[src/trunk]: src/distrib/notes clean up whitespace and formatting

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

details:   https://anonhg.NetBSD.org/src/rev/496f5d25b38a
branches:  trunk
changeset: 533440:496f5d25b38a
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sun Jun 30 12:34:38 2002 +0000

description:
clean up whitespace and formatting

diffstat:

 distrib/notes/sgimips/install |  79 +++++++++++++++++++----------------
 distrib/notes/sgimips/prep    |  26 ++++++----
 distrib/notes/shark/hardware  |   7 +-
 distrib/notes/shark/install   |  30 ++++++------
 distrib/notes/shark/prep      |  19 ++++----
 distrib/notes/shark/whatis    |   5 +-
 distrib/notes/sparc/hardware  |  29 ++++++++----
 distrib/notes/sparc/install   |  96 ++++++++++++++++++++++++++----------------
 distrib/notes/sparc/prep      |  29 ++++++------
 distrib/notes/sparc/upgrade   |  20 +++++---
 10 files changed, 194 insertions(+), 146 deletions(-)

diffs (truncated from 865 to 300 lines):

diff -r 231182bab034 -r 496f5d25b38a distrib/notes/sgimips/install
--- a/distrib/notes/sgimips/install     Sun Jun 30 12:30:20 2002 +0000
+++ b/distrib/notes/sgimips/install     Sun Jun 30 12:34:38 2002 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: install,v 1.2 2002/05/23 05:44:50 pooka Exp $
+.\"    $NetBSD: install,v 1.3 2002/06/30 12:34:38 lukem Exp $
 .\"
-.\" Copyright (c) 1999, 2000, 2002 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -54,31 +54,33 @@
 .if 0 \{\
 .It
 Copying a bootable diskimage onto the beginning of a disk and installing
-onto that disk.  See the
+onto that disk.
+See the
 .Sx Diskless installation
 section later in these INSTALL notes.
 .\}
 .It
-Installation in a diskless environment.  This means that you will install
+Installation in a diskless environment.
+This means that you will install
 your entire system onto a remotely shared disk.
 .It
-Booting the install kernel over the network and installing onto a local
-disk.  The beginning of the procedure is similar to diskless installation,
+Booting the install kernel over the network and installing onto a local disk.
+The beginning of the procedure is similar to diskless installation,
 but you will eventually end up writing the system onto your local disk.
 .if 0 \{\
 .It
-Using a helper machine with a SCSI controller to copy the bootable
-diskimage onto the beginning of a disk, and moving the disk to the
-target machine.  See the
+Using a helper machine with a SCSI controller to copy the bootable diskimage
+onto the beginning of a disk, and moving the disk to the target machine.
+See the
 .Sx Install via diskimage
 section later in these INSTALL notes.
-.\} 
+.\}
 .enum)
 .Pp
 You should familiarize yourself with the console PROM environment
-and the hardware configuration.  A good place to study PROM tricks
-is the IRIX "prom" manual page.
-Be sure you know how to print the configuration of your machine, 
+and the hardware configuration.
+A good place to study PROM tricks is the IRIX "prom" manual page.
+Be sure you know how to print the configuration of your machine,
 and how to boot from disk or network, as appropriate.
 .Pp
 To boot from disk, use:
@@ -92,9 +94,9 @@
 .Dl ">> setenv osloader boot"
 .bullet)
 .Pp
-For all 
+For all
 drives (including all SCSI-2 drives), the kernel should correctly detect
-the disk geometry. 
+the disk geometry.
 .Pp
 If you're installing
 .Nx*M
@@ -103,38 +105,40 @@
 installing
 .Nx .
 Changing the size of partitions after you've
-installed is difficult.  If you do not have a spare bootable disk, it
-may be simpler to re-install
+installed is difficult.
+If you do not have a spare bootable disk, it may be simpler to re-install
 .Nx
 again from scratch.
 .Pp
 To be able to boot from local disk an
-SGI Volume Header partition is required.  This special partition is accessed
-by the PROM to load the
+SGI Volume Header partition is required.
+This special partition is accessed by the PROM to load the
 .Nx*M
-boot program.  The partition should be about
-2 MB in size, but can be reduced somewhat.  The minimum size can approach
-150k, but this doesn't leave room for upgrade boot programs.
+boot program.
+The partition should be about 2 MB in size, but can be reduced somewhat.
+The minimum size can approach 150k, but this doesn't leave room for
+upgrade boot programs.
 .
 .Ss2 Install via a bootable CD-ROM
 .
 The
 .Nx*M
-CD-ROM is not ISO-formatted.  Since the older SGI PROMs
-do not understand ISO/CD-9660 formats, the CD-ROM image is generated with an
-SGI Volume Header and an FFS-formatted (BSD4.2) partition for the distribution.
+CD-ROM is not ISO-formatted.
+Since the older SGI PROMs do not understand ISO/CD-9660 formats,
+the CD-ROM image is generated with an SGI Volume Header and an
+FFS-formatted (BSD4.2) partition for the distribution.
 Furthermore, since the filesystem is FFS, the CD cannot be mounted under IRIX.
 .Pp
 To install from a
 .Nx*M
 CD-ROM, follow the procedure above for
 setting the PROM environment for SystemPartition, OSLoadPartition, OSLoader
-and OSLoadFilename.  The SCSI and DISK values used should be for your attached
-CD-ROM drive, where
+and OSLoadFilename.
+The SCSI and DISK values used should be for your attached CD-ROM drive, where
 .Ar X
 is the SCSI-ID of the CD-ROM.
 .
-Using the PROM command-line interface, 
+Using the PROM command-line interface,
 you can boot the CD-ROM installation kernel as follows:
 .Pp
 .(tag 12n -offset indent -compact
@@ -146,14 +150,16 @@
 and NFS services on your server.
 .Pp
 .(enum
-Place the kernel into the TFTP server's download area.  If the
-kernel has a
+Place the kernel into the TFTP server's download area.
+If the kernel has a
 .Dq .gz
 suffix, you must first uncompress it using the
 .Pa gunzip
-program.  You must also decide which kernel you need to boot.  Because of
-differences in SGI hardware between different machines, the kernel load
-addresses differ. You will need GENERIC_INDY for the Indy and Indigo2,
+program.
+You must also decide which kernel you need to boot.
+Because of differences in SGI hardware between different machines,
+the kernel load addresses differ.
+You will need GENERIC_INDY for the Indy and Indigo2,
 while GENERIC should be enough for the O2.
 .Pp
 .Dl server# Ic cp netbsd-GENERIC /tftpboot/netbsd-sgimips
@@ -178,12 +184,13 @@
 .Pp
 The installation of your diskless
 .Nx*M
-system is now complete!  You may now skip ahead to any post-installation
-instructions.
+system is now complete!
+You may now skip ahead to any post-installation instructions.
 .Ss2 Once you've booted the diskimage
 .
 Once you've booted the installation kernel you will need to
-select your terminal type.  Use
+select your terminal type.
+Use
 .Ic iris-ansi
 for an SGI graphics console (Not currently supported)
 .Ic vt100
diff -r 231182bab034 -r 496f5d25b38a distrib/notes/sgimips/prep
--- a/distrib/notes/sgimips/prep        Sun Jun 30 12:30:20 2002 +0000
+++ b/distrib/notes/sgimips/prep        Sun Jun 30 12:34:38 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.2 2002/05/23 05:44:50 pooka Exp $
+.\"    $NetBSD: prep,v 1.3 2002/06/30 12:34:38 lukem Exp $
 .
 First and foremost, before beginning the installation process,
 .Em make sure you have a reliable backup
@@ -6,12 +6,13 @@
 .Pp
 Booting
 .Nx*M
-for the first time is most commonly done from the network. You must
-set up DHCP, TFTP, and NFS for the installation procedure to be
-successful. Some SGI bootproms, such as the ones found on O2s, can read
+for the first time is most commonly done from the network.
+You must set up DHCP, TFTP, and NFS for the installation procedure to be
+successful.
+Some SGI bootproms, such as the ones found on O2s, can read
 ELF kernels directly from the network, others require that you boot
-an ECOFF version of the kernel. You will notice this from the following
-message from PROM:
+an ECOFF version of the kernel.
+You will notice this from the following message from PROM:
 .Pp
 .Dl Illegal f_magic number 0x7f45, expected MIPSELMAGIC or MIPSEBMAGIC.
 .Pp
@@ -21,8 +22,9 @@
 tool.
 .Pp
 Different SGI hardware will require the executable code in the loadable
-image to start at a different address.  You must decide which image your
-system is capable of loading.  The current options are:
+image to start at a different address.
+You must decide which image your system is capable of loading.
+The current options are:
 .(bullet
 Indigo2, Indy, Challenge S
 .It
@@ -34,9 +36,11 @@
 correct image for your system.
 .Pp
 Note that some older bootproms have an interesting bug in reading the
-kernel via TFTP. They handle the port number as a signed entity, and
-can thus not connect to ports >32767. You can work around this problem
-on the TFTP server (given that it is a NetBSD host) by using
+kernel via TFTP.
+They handle the port number as a signed entity, and
+can thus not connect to ports >32767.
+You can work around this problem on the TFTP server
+(given that it is a NetBSD host) by using
 .Dq sysctl
 to set
 .Dq net.inet.ip.anonportmin
diff -r 231182bab034 -r 496f5d25b38a distrib/notes/shark/hardware
--- a/distrib/notes/shark/hardware      Sun Jun 30 12:30:20 2002 +0000
+++ b/distrib/notes/shark/hardware      Sun Jun 30 12:34:38 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: hardware,v 1.1 2002/03/30 09:12:40 thorpej Exp $
+.\"    $NetBSD: hardware,v 1.2 2002/06/30 12:36:54 lukem Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -30,7 +30,7 @@
 .\" 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.
-.\" 
+.\"
 .Nx*M
 runs on systems based on the Digital Network Appliance Reference
 Design (or DNARD, pronounced
@@ -44,7 +44,8 @@
 .Nx*M
 supports all of the standard on-board devices on the DNARD:
 .(bullet -compact
-IDE interface.  Some models included an IDE ZIP drive.
+IDE interface.
+Some models included an IDE ZIP drive.
 .It
 PS/2 keyboard and mouse ports
 .It
diff -r 231182bab034 -r 496f5d25b38a distrib/notes/shark/install
--- a/distrib/notes/shark/install       Sun Jun 30 12:30:20 2002 +0000
+++ b/distrib/notes/shark/install       Sun Jun 30 12:34:38 2002 +0000
@@ -1,11 +1,11 @@
-.\"     $NetBSD: install,v 1.1 2002/03/30 09:12:40 thorpej Exp $
-.\" 
-.\" Copyright (c) 1999, 2000, 2002 The NetBSD Foundation, Inc.
+.\"     $NetBSD: install,v 1.2 2002/06/30 12:36:54 lukem Exp $
+.\"
+.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
-.\"  
+.\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
-.\" are met: 
+.\" are met:
 .\" 1. Redistributions of source code must retain the above copyright
 .\"    notice, this list of conditions and the following disclaimer.
 .\" 2. Redistributions in binary form must reproduce the above copyright
@@ -18,7 +18,7 @@
 .\" 4. Neither the name of The NetBSD Foundation nor the names of its
 .\"    contributors may be used to endorse or promote products derived
 .\"    from this software without specific prior written permission.
-.\" 
+.\"
 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
@@ -29,8 +29,8 @@
 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY 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. 
-.\" 
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
 .
 The steps taken for installing
 .Nx*M
@@ -40,8 +40,8 @@
 and NFS services on your server.
 .Pp
 .(enum
-Place the kernel into the TFTP server's download area.  If the
-kernel has a
+Place the kernel into the TFTP server's download area.
+If the kernel has a
 .Dq .gz
 suffix, you must first uncompress it using the
 .Pa gunzip
@@ -67,8 +67,8 @@
 .Pp
 The installation of your diskless
 .Nx*M