Make a pass at mac68k install documentation.

distrib/notes/mac68k/contents

@@ -0,0 +1,94 @@
+The mac68k-specific portion of the NetBSD 1.0 release is found in the
+"mac68k" subdirectory of the distribution.  That subdirectory is laid
+out as follows:
+
+.../NetBSD-1.0/mac68k/
+			binary/		mac68k binary distribution sets;
+					see below.
+
+			security/	mac68k security distribution;
+					see below.
+
+			utils/		The mac68k installation utilities.
+
+The NetBSD/mac68k binary distribution sets contain the binaries which
+comprise the NetBSD 1.0 release for the mac68k.  There are eight binary
+distribution sets, and the "security" distribution set.  The binary
+distribution sets can be found in subdirectories of the "mac68k/binary"
+subdirectory of the NetBSD 1.0 distribution tree, and are as follows:
+
+	netbsd10 The NetBSD/mac68k 1.0 kernel binary.  You MUST
+		install this file.  It is the kernel that you need
+		to boot the system.
+		[ 307K gzipped, 610K uncompressed ]
+
+	base10	The NetBSD/mac68k 1.0 base binary distribution.  You
+		MUST install this distribution set.  It contains the
+		base NetBSD utilities that are necessary for the
+		system to run and be minimally functional.  It
+		includes shared library support, and excludes
+		everything described below.
+		[ 6.2M gzipped, 18.4M uncompressed ]
+
+	comp10	The NetBSD/mac68k Compiler tools.  All of the tools
+		relating to C, C++, and FORTRAN (yes, there are two!).
+		This set includes the system include files
+		(/usr/include), the linker, the compiler tool chain,
+		and the various system libraries (except the shared
+		libraries, which are included as part of the base
+		set).  This set also includes the manual pages for all
+		of the utilities it contains, as well as the system
+		call and library manual pages.
+		[ 4.1M gzipped, 12.8M uncompressed ]
+
+	etc10	This distribution set contains the system
+		configuration files that reside in /etc and in several
+		other places.  This set MUST be installed if you are
+		installing the system from scratch, but should NOT be
+		used if you are upgrading.  (If you are upgrading,
+		it's recommended that you get a copy of this set and
+		CAREFULLY upgrade your configuration files by hand.)
+		[ 50K gzipped, 280K uncompressed ]
+
+	games10	This set includes the games and their manual pages.
+		[ 1.0M gzipped, 3.0M uncompressed ]
+
+	man10	This set includes all of the manual pages for the
+		binaries and other software contained in the base set.
+		Note that it does not include any of the manual pages
+		that are included in the other sets.
+		[ 0.7M gzipped, 2.8M uncompressed ]
+
+	misc10	This set includes the system dictionaries (which are
+		rather large), the typesettable document set, and
+		man pages for other architectures which happen to be
+		installed from the source tree by default.
+		[ 1.6M gzipped, 5.7M uncompressed ]
+
+	text10	This set includes NetBSD's text processing tools,
+		including groff, all related programs, and their
+		manual pages.
+		[ 0.8M gzipped, 2.9M uncompressed ]
+
+The mac68k security distribution set is named "secr10" and can be found
+in the "mac68k/security" subdirectory of the NetBSD 1.0 distribution
+tree.  It contains the crypt libraries (for the DES encryption algorithm)
+and the binaries which depend on it.  It can only be found on those sites
+which carry the complete NetBSD distribution and that can legally obtain
+it.  (Remember, because of United States law, this distribution set may
+not be exported to locations outside of the United States and Canada.)
+[ 109K gzipped, 260K uncompressed ]
+
+The mac68k binary distribution sets are distributed in the same form as
+the source distribution sets; catted together, the members of a set
+form a gzipped tar file.
+
+The instructions given for extracting the source sets work equally
+well for the binary sets, but it is worth noting that if you use that
+method, the files are extracted "below" the current directory.  That
+is, if you want to extract the binaries "into" your system, i.e.
+replace the system binaries with them, you have to run the "tar xfp"
+from /.  Also note that if you upgrade or install this way, those
+programs that you are using at the time will NOT be replaced.  If you
+follow the normal installation or upgrade procedures, this will be
+taken care of for you.

distrib/notes/mac68k/hardware

@@ -0,0 +1,37 @@
+NetBSD/mac68k 1.0 runs on several of the older Macintosh computers.
+4MB of RAM should be sufficient to boot and the system can probably
+be squeezed onto a 40MB hard disk by leaving off a package or two.
+To actually do much compiling or anything more interesting than
+booting, at least 8MB of RAM and more disk space is recommended.
+About 50MB will be necessary to install all of the NetBSD 1.0 binary
+distribution (note that this does not count swap space!).  Much more
+disk space is required to install the source and objects as well (about
+another 105MB).
+
+Supported models:
+	Mac II
+	Mac IIx
+	Mac IIcx
+	Mac IIci
+	Mac SE/30
+
+Supported devices on all of the above systems include:
+	Internal SCSI bus and most SCSI tapes, hard drives, and CD-ROMs
+	Internal sound--enough to beep, anyway
+	Most basic NuBUS video cards (there have been some
+		problems with some 24-bit color cards)
+	Both internal serial ports
+	ADB keyboards and mice
+	
+Some systems will boot and are usable from an external terminal
+(serial tty or SL/IP):
+	Mac IIsi
+	Mac IIvx
+	possibly others
+
+What isn't supported, but often asked about:
+	Ethernet cards.  There is a driver that is very close to working
+		for a number of cards.  Contributions are very welcome.
+	68040-based Macs.  Work is in progress on getting a Quadra 700
+		running.  This requires a new scsi driver and a new
+		ethernet driver.

distrib/notes/mac68k/install

@@ -0,0 +1,119 @@
+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.
+
+**** Preparing the filesystem(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.
+Select the partition on which you wish to build a filesystem and click
+on the "Format" button.  You will now be asked for a bunch of parameters
+for the hard drive and the filesystem.  Usually, you can just take the
+defaults.  If you are installing onto a Syquest, please see the FAQ.
+Note that although this dialog only has the "OK" button, you are not
+committed, yet.  Once you get the values you want, press the "OK" button.
+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
+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 "I Read It" button and the program will quit.
+
+Repeat as necessary for any extra partitions that you wish to make
+filesystems on.  Note that you do _not_ need a filesystem on your swap
+partition.
+
+**** Installing the files
+
+Double-click on the Install Utility 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.
+
+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),"
+	above.
+
+	When you started the installer, it mounted your root partition.
+	Just before it printed, "Mounting partition 'A' as /," it printed
+	lines like:
+		sd1 at scsi ID 5.
+	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.
+
+	You will need to know the proper device to mount the remaining
+	partition(s) by hand:
+
+		* Select "Build Devices" from the "File" menu.
+
+		* 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
+		  the first scsi disk, sd0, on /usr, you would type:
+			mount /dev/sd0g /usr
+
+		* Type "quit" after you have mounted all the filesystems.
+
+Installation of base files:
+
+	Select the "Install" menu item from the "File" menu and install
+	base10, netbsd, 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
+	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.
+
+**** Booting the system
+
+Double-click on the MacBSD Booter icon to start the application.  Check
+that the options in the Booting dialog look sane--especially the SCSI ID.
+If not, correct them to your preference.  When you are satisfied with
+your choices, try booting NetBSD.
+
+If you wish to save your preferences, choose the "Save Preferences"
+option in the "File" menu, then quit the application and restart.  Due
+to a long-standing bug, the preferences will not be saved unless you
+quit.
+
+If the system does not come up:
+	* Check the "diagnostic gray bars" check-box.
+	* Count the number of "gray bars" you see.
+	* Send mail to alice@cray-ymp.acm.stuorg.vt.edu describing
+	  your software, your hardware, and the number of bars that
+	  you saw.
+
+If the system does come up, congratulations, you have successfully
+installed NetBSD 1.0.  When you reboot into NetBSD, you should log
+in as "root" at the login prompt.  There is no initial password, but
+if you're using the machine in a networked environment, you should
+create yourself an account and protect it and the "root" account with
+good passwords.
+
+Some of the files in the NetBSD 1.0 distribution might need to be
+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.

distrib/notes/mac68k/legal

@@ -0,0 +1,5 @@
+	This product includes software developed by the Alice Group.
+
+	This product includes software developed by Christopher G. Demetriou.
+
+	This product includes software developed by Christian E. Hopps.

distrib/notes/mac68k/prep

@@ -0,0 +1,33 @@
+Find your favorite disk partitioning utility.  Some
+of the ones that have been tried and seem to work are:
+	SCSI Directory Lite
+	Disk Manager Mac from OnTrack
+	HD SC Setup from Apple
+	I/O Formatter from Diversified (?)
+	Silverlining from LaCie
+	APS Disk Tools
+
+The last can be found on any A/UX ftp site--for example:
+jagubox.gsfc.nasa.gov:/pub/mac/APS273.sit.hqx, or
+dunkin.princeton.edu:/pub/jagubox/mac/APS273.sit.hqx.
+
+** First, be sure you have a reliable backup of any data
+** which you may want to keep.  Repartitioning your hard
+** drive is an excellent way to destroy important data.
+
+Second, use your favorite partitioning utility to make
+at least an A/UX "Root & Usr" partition and an A/UX "Swap"
+partition.  The "Root & Usr" partition should be _at least_
+50MB in size if you wish to install everything.  Generally,
+you should allocate twice as much swap space as you have real
+memory (so, if you have 8MB of RAM, specify 16MB of swap space).
+Systems that will be heavily used or that are low on real
+memory should have more swap space allocated.  Systems that
+will be only lightly used can get away with less.
+
+If you like, you can also create a smaller root partition
+and a larger /usr.  If you plan to use this machine as a
+server, you may also want a separate /var.  Create these
+partitions as the BSD "usr" or "User slice X" type.
+
+You are now set to install NetBSD on your hard drive.

distrib/notes/mac68k/upgrade

@@ -0,0 +1,4 @@
+There is no upgrade to release 1.0 for the NetBSD/mac68k architecture.
+This is impractical as there is no good, standard point to provide an
+upgrade path from.  It is hoped that there will be a good upgrade
+procedure for future releases.

distrib/notes/mac68k/whatis

@@ -0,0 +1,6 @@
+NetBSD 1.0 is the first "real" release of NetBSD for the mac68k.
+Previous releases have been alpha or beta quality.  There is still a
+lot of work to be done, but this should be a usable system for quite
+a few people.  Quite a few features are available: shared libraries,
+new file systems, binary compatibility with the other m68k ports for
+most binaries, SunOS compatibility and numerous others.

distrib/notes/mac68k/xfer

@@ -0,0 +1,26 @@
+Installation is really only supported from the local Macintosh
+hard drive.  This means that you'll need at least enough room
+for the largest file that you will have to install.  This is the
+6.2M base10 file.  There has been talk of allowing an install
+from split files or over Appleshare.  If you have the time, desire,
+and knowledge, please feel free to add that functionality.
+
+There will be two images of each file.  One in "raw" Unix format
+and one in a binhex format.  Therefore, base10 and base10.hqx both
+contain the same information, but base10.hqx has been encoded in
+binhex format.  Download the files; if necessary, decode them so
+you have all of the files as base10, etc10, etc.  This can be
+accomplished from the .hqx files by using _Stuffit Expander_ or
+any one of a number of freeware and shareware Macintosh tools.
+
+You will also need to collect the MacOS tools:
+	Mkfs,
+	MacBSD Install Utility, and
+	MacBSD Booter.
+
+These three are compacted and in binhex form as mkfs.cpt.hqx,
+installer.1.0.cpt.hqx, and booter.1.4.cpt.hqx, respectively.
+
+Extract them as you would any other Macintosh applications.  The
+sources should be in the same place with "src" somewhere in the
+filename.