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

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

details:   https://anonhg.NetBSD.org/src/rev/bd1d3a92ddc4
branches:  trunk
changeset: 533419:bd1d3a92ddc4
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jun 29 23:54:05 2002 +0000

description:
clean up whitespace and formatting

diffstat:

 distrib/notes/mac68k/contrib  |    8 +-
 distrib/notes/mac68k/hardware |   43 +++++++------
 distrib/notes/mac68k/install  |  132 +++++++++++++++++++++++------------------
 distrib/notes/mac68k/prep     |   54 +++++++++-------
 distrib/notes/mac68k/upgrade  |  123 +++++++++++++++++++++-----------------
 distrib/notes/mac68k/whatis   |    5 +-
 distrib/notes/mac68k/xfer     |   30 +++++----
 7 files changed, 219 insertions(+), 176 deletions(-)

diffs (truncated from 801 to 300 lines):

diff -r 611528182036 -r bd1d3a92ddc4 distrib/notes/mac68k/contrib
--- a/distrib/notes/mac68k/contrib      Sat Jun 29 22:37:39 2002 +0000
+++ b/distrib/notes/mac68k/contrib      Sat Jun 29 23:54:05 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contrib,v 1.3 2000/10/29 14:08:07 lukem Exp $
+.\"    $NetBSD: contrib,v 1.4 2002/06/29 23:54:05 lukem Exp $
 .
 .Ss Contributions
 .Pp
@@ -71,8 +71,8 @@
 still unsupported, helped to track down memory management
 bugs for '030-based machines.
 .It
-Bill Studenmund for providing a stable front end to the machine-
-independent serial driver.
+Bill Studenmund for providing a stable front end to the
+machine-independent serial driver.
 .It
 Schuyler Stultz for the loan of his Macintosh II when we
 desperately needed another machine on which to compile
@@ -82,7 +82,7 @@
 access to several machines and documentation after hours.
 .It
 Virginia Tech English Department for loan of a IIci w/ NuBus
-video and 32 MB of RAM - the first IIci to run
+video and 32 MB of RAM \(em the first IIci to run
 .Nx*M .
 .It
 Colin Wood for maintaining a host of
diff -r 611528182036 -r bd1d3a92ddc4 distrib/notes/mac68k/hardware
--- a/distrib/notes/mac68k/hardware     Sat Jun 29 22:37:39 2002 +0000
+++ b/distrib/notes/mac68k/hardware     Sat Jun 29 23:54:05 2002 +0000
@@ -1,18 +1,18 @@
-.\"    $NetBSD: hardware,v 1.19 2002/06/20 13:24:37 itojun Exp $
+.\"    $NetBSD: hardware,v 1.20 2002/06/29 23:54:05 lukem Exp $
 .
 .Nx*M
 \*V runs on several of the older Macintosh computers.
 About 4 MB of RAM might be sufficient to boot, and the system can probably
 be squeezed onto a 40 MB hard disk by leaving off an unnecessary set or two.
 To actually do much compiling or anything more interesting than booting, at
-least 8 MB of RAM and more disk space is recommended. About 95 MB will be
-necessary to install all of the
+least 8 MB of RAM and more disk space is recommended.
+About 95 MB will be necessary to install all of the
 .Nx \*V
 binary system distribution
-sets (note that this does not count swap space!). An additional 30 MB or so
-is needed for the binary X11 distribution sets. Much more disk space is
-required to install the source and objects as well (at least another 300
-MB).
+sets (note that this does not count swap space!).
+An additional 30 MB or so is needed for the binary X11 distribution sets.
+Much more disk space is required to install the source and objects as well
+(at least another 300 MB).
 .
 .Ss2 Supported models
 .(bullet -compact -offset indent
@@ -37,7 +37,7 @@
 .(bullet -compact -offset indent
 Onboard SCSI bus and most SCSI tapes, hard drives, and CD-ROMs
 .It
-Internal sound - enough to beep on some machines, anyway
+Internal sound \(em enough to beep on some machines, anyway
 .It
 Most basic NuBus video cards (there have been some
 problems with some 24-bit color cards and with most
@@ -50,7 +50,7 @@
 .It
 Ethernet cards based on the National Semiconductor 8390 and the
 SONIC (DP83932) chips
-(Asante, Apple, and a few others - problems still
+(Asante, Apple, and a few others \(em problems still
 with Ethernet and many NuBus video cards)
 .It
 Ethernet cards based on the SMC 91c92 and 91c100 (FEAST) chips.
@@ -77,8 +77,8 @@
 .bullet)
 .Pp
 If your 68LC040 system is not listed above, it is due to a problem with
-floating point emulation (FPE) for this type of processor. Machines in
-this category include:
+floating point emulation (FPE) for this type of processor.
+Machines in this category include:
 .(bullet -compact -offset indent
 Newer LC-series machines
 .It
@@ -92,7 +92,8 @@
 Macintosh IIfx
 .Pp
 This machine has unusual custom chips for the ADB and serial interfaces
-which make support for it difficult. Work is in progress on this, though.
+which make support for it difficult.
+Work is in progress on this, though.
 .It
 Quadra 900/950
 .Pp
@@ -101,9 +102,10 @@
 .It
 PowerPC-based Macs
 .Pp
-This is a separate effort from the \*M port. PowerMacs use hardware that
-is often fairly different from that of the \*M port.  If you are
-interested in this, you might want to take a look at the new
+This is a separate effort from the \*M port.
+PowerMacs use hardware that is often fairly different from that of
+the \*M port.
+If you are interested in this, you might want to take a look at the new
 .Nx Ns /macppc
 port:
 .Lk http://www.netbsd.org/Ports/macppc/index.html
@@ -115,9 +117,10 @@
 .Pp
 Due to oddities of the Macintosh hardware interrupt priority scheme,
 .Nx*M
-keeps very poor time. Under a high interrupt load (e.g.
-SCSI or serial port activity) , a machine can lose several minutes
-per hour. A consequence of this problem is that attempting to run
+keeps very poor time.
+Under a high interrupt load (e.g. SCSI or serial port activity),
+a machine can lose several minutes per hour.
+A consequence of this problem is that attempting to run
 .Ic xntpd
 is rather pointless unless you periodically call
 .Ic ntpdate .
@@ -129,8 +132,8 @@
 SCSI drivers are not quite as
 robust as their
 .Tn MacOS
-counterparts. Symptoms of these
-problems are that some SCSI disks will not work under
+counterparts.
+Symptoms of these problems are that some SCSI disks will not work under
 NetBSD that work fine under
 .Tn MacOS .
 Other problems include
diff -r 611528182036 -r bd1d3a92ddc4 distrib/notes/mac68k/install
--- a/distrib/notes/mac68k/install      Sat Jun 29 22:37:39 2002 +0000
+++ b/distrib/notes/mac68k/install      Sat Jun 29 23:54:05 2002 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: install,v 1.24 2002/04/15 20:57:55 gmcgarry Exp $
+.\"    $NetBSD: install,v 1.25 2002/06/29 23:54:05 lukem Exp $
 .\"
-.\" Copyright (c) 1999, 2000 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
@@ -43,62 +43,69 @@
 .
 .Ss2 Preparing the file system(s)
 .
-Double-click on the Mkfs application icon to start it up. It will ask you
-for the SCSI-ID of the drive that you are installing upon. Once this is
-selected, it will present a list of the partitions on that disk. You must
-first convert the partitions to a type which
+Double-click on the Mkfs application icon to start it up.
+It will ask you for the SCSI-ID of the drive that you are installing upon.
+Once this is selected, it will present a list of the partitions on that disk.
+You must first convert the partitions to a type which
 .Nx
-can understand. Select
-each partition on which you wish to build a file system and click on the
+can understand.
+Select each partition on which you wish to build a file system and click on the
 .Dq Change
-button. If you are placing the entire installation on a single
-partition, select the
+button.
+If you are placing the entire installation on a single partition, select the
 .Dq NetBSD Root\*&Usr
-radio button. If you are using
-multiple partitions, select
+radio button.
+If you are using multiple partitions, select
 .Dq NetBSD Root
 for the root partition
 .Pq Pa /
 and
 .Dq NetBSD Usr
-for all the other partitions. You should select
+for all the other partitions.
+You should select
 .Dq NetBSD Swap
 for the swap partition.
 .Pp
 When you have finished converting each partition, select each partition and
 click on the
 .Dq Format
-button. You will now be asked for a bunch of
-parameters for the hard drive and the file system. Usually, you can just
-take the defaults. If you are installing onto removable media (e.g. a Zip,
-Jaz, or Syquest), please see the FAQ. Note that although this dialog only
-has the
+button.
+You will now be asked for a bunch of
+parameters for the hard drive and the file system.
+Usually, you can just take the defaults.
+If you are installing onto removable media (e.g. a Zip, Jaz, or Syquest),
+please see the FAQ.
+Note that although this dialog only has the
 .Dq OK
-button, you are not committed, yet. Once you get the values
-you want, press the
+button, you are not committed, yet.
+Once you get the values you want, press the
 .Dq OK
-button. A dialog will be presented at this point
-with two options:
+button.
+A dialog will be presented at this point with two options:
 .Dq Format
 and
 .Dq Cancel .
 If you choose
 .Dq Cancel ,
-nothing will be written to your drive. If you choose
+nothing will be written to your drive.
+If you choose
 .Dq Format ,
 the program will
 proceed to make a file system.
 .Pp
-Mkfs is not a well-behaved Macintosh application. It will not allow any
-other tasks to run while it does (cooperative multitasking at its best).
+Mkfs is not a well-behaved Macintosh application.
+It will not allow any other tasks to run while it does
+(cooperative multitasking at its best).
 When it's finished, the program will put up a dialog to ask if you have
-scanned the output for any error messages. Usually there won't have been
-any errors, but do scan the output to make sure. Simply click on the
+scanned the output for any error messages.
+Usually there won't have been any errors, but do scan the output to make sure.
+Simply click on the
 .Dq "I Read It"
 button and the program will quit.
 .Pp
 Repeat as necessary for any extra partitions that you wish to make
-file systems on. Note that you do
+file systems on.
+Note that you do
 .Em not
 need a file system on your swap partition.
 .Pp
@@ -113,14 +120,17 @@
 .Ss2 Installing the files
 .
 Before using the Installer, it is probably a good idea to increase its
-memory allocation. Select the Installer icon by clicking on it and choose
+memory allocation.
+Select the Installer icon by clicking on it and choose
 .Dq Get Info
-from the File menu. Increase both the Minimum and Preferred
-sizes to as much as you can spare.
+from the File menu.
+Increase both the Minimum and Preferred sizes to as much as you can spare.
 .Pp
-Double-click on the Installer icon to start it up. The Installer will
-present the same SCSI-ID menu that Mkfs did. Select the same SCSI-ID that
-you did for Mkfs - i.e., the one you are installing onto.
+Double-click on the Installer icon to start it up.
+The Installer will
+present the same SCSI-ID menu that Mkfs did.
+Select the same SCSI-ID that you did for Mkfs \(em
+i.e., the one you are installing onto.
 .Pp
 If you are installing onto a single root partition
 .Pq Pa / ,
@@ -149,7 +159,8 @@
 This means that the device for SCSI-ID 5 is
 .Li sd1 .
 The partitions
-are signified by a trailing letter. For instance,
+are signified by a trailing letter.
+For instance,
 .Li sd1a
 would be
 the root partition
@@ -220,8 +231,9 @@
 menu and install
 .Pa base.tgz , etc.tgz , netbsd.tgz ,
 and any other sets you wish to
-install        at this time. (See the contents section for information
-about what's in each set.) The Installer will print out the
+install        at this time.
+(See the contents section for information about what's in each set.)
+The Installer will print out the
 filename of each file as it is installed, and will take quite some
 time to install everything (the base package alone can take over an
 hour on a slow hard drive).
@@ -234,13 +246,13 @@
 .Ic Build Devices
 option from the
 .Ic File
-menu if you have not already done
-so. This will create a bunch of device nodes for you and will
+menu if you have not already done so.
+This will create a bunch of device nodes for you and will
 create your initial
 .Pa /etc/fstab .