Grammar, be nitpicky about the term "MacOS", and other general fixes

including better examples in some cases and less patronizing language.

1 files changed, 29 insertions, 20 deletions

diff --git a/distrib/notes/mac68k/install b/distrib/notes/mac68k/install
index da3c4e2742f..bc401b79d52 100644
--- a/distrib/notes/mac68k/install
+++ b/distrib/notes/mac68k/install
@@ -1,7 +1,7 @@
 The installation can be broken down into three basic steps:
-	* Run Mkfs to build a filesystem or filesystems.
-	* Run Install Utility to load the files onto your filesystems.
-	* Run the booter to boot the system.
+	* Running Mkfs to build a filesystem or filesystems.
+	* Running Install Utility to load the files onto your filesystems.
+	* Running the booter to boot the system.
 
 **** Preparing the filesystem(s)
 
@@ -18,7 +18,7 @@ A dialog will be presented at this point with two options: "Format" and
 "Cancel."  If you choose "Cancel," nothing will be written to your drive.
 If you choose "Format," the program will proceed to make a filesystem.
 
-Mkfs is not a well-behaved Macintosh application.  It will not allow
+Mkfs is not a well-behaved MacOS 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
@@ -39,7 +39,7 @@ If you are installing onto a single root partition, proceed to the
 "Installation of base files" section, below.
 
 	If you have not created filesystems for the root, usr, and
-	any other filesystems, go back to "Preparing the filesystem(s),"
+	any other partitions, go back to "Preparing the filesystem(s),"
 	above.
 
 	When you started the installer, it mounted your root partition.
@@ -49,41 +49,47 @@ If you are installing onto a single root partition, proceed to the
 	This means that the device for scsi ID 5 is sd1.  The partitions
 	are signified by a trailing letter.  For instance, sd1a would be
 	the root partition of the second scsi disk in the chain, and sd0g
-	would be the first usr partition on the first scsi disk.
+	would be the first usr partition on the first scsi disk.  It is
+	important to emphasize that device numbers after the 'sd' do not
+	correspond to SCSI IDs of disks but rather to logical disks.  The
+	lowest SCSI ID will always be sd0 proceeded by increasing ID
+	numbers.
 
 	You will need to know the proper device to mount the remaining
 	partition(s) by hand:
 
-		* Select "Build Devices" from the "File" menu.
+		* Select "Build Devices" from the "File" menu.  This builds
+		  the necessarry tree of device files on your filesystem in
+		  /dev.
 
 		* Select "Mini Shell" from the "File" menu.
 
 		* Mount the filesystems you wish with the command:
 			mount device path
-		  For example, if you wish to mount a usr partition from
+		  For example, if you wish to mount the second partition from
 		  the first scsi disk, sd0, on /usr, you would type:
-			mount /dev/sd0g /usr
+			mount /dev/sd0b /usr
 
-		* Type "quit" after you have mounted all the filesystems.
+		* Type "quit" to exi the minishell after you have mounted
+		  all the filesystems.
 
 Installation of base files:
 
 	Select the "Install" menu item from the "File" menu and install
-	base22, bsd, and any other packages you wish to install at
-	this time (see the contents section for information about what's
-	in each package).  The installer will print out the filename of
-	each file as it is installed, and will take quite some time to
-	install everything.
+	base22.tar.gz, bsd22.tar.gz, comp22.tar.gz, and any other packages
+	you wish to install at this time (see the contents section for
+	information about what's in each package).  The installer will
+	print out the filename of each file as it is installed and will
+	take quite some time to install everything.
 
 	As is the case with Mkfs, this is not a particularly well-behaved
-	Macintosh application and the machine will be completely tied up
+	MacOS application and the machine will be completely tied up
 	while the installation takes place.
 
 	At some point after installing the base package, select the "Build
 	Devices" option from the "File" menu.  This will create a bunch of
-	device nodes for you and will create your initial /etc/fstab.  The
-	installer program also has an option to give you a mini-shell.  Do
-	not use this unless you know what you are doing.
+	device nodes for you in /dev and your initial /etc/fstab.  The
+	installer program also has an option to give you a mini-shell.
 
 **** Booting the system
 
@@ -109,4 +115,7 @@ tailored for your site.  In particular, the /etc/sendmail.cf file will
 almost definitely need to be adjusted, and other files in /etc will
 probably need to be modified, as well.  If you are unfamiliar with
 UN*X-like system administration, it's recommended that you buy a book
-that discusses it.
+that discusses it.  Also, a useful resource in getting to know your new
+system is the *BSD FAQ which is available from numerous sights on the
+Internet.
+