[src/netbsd-1-6]: src/distrib/notes/mac68k Pull up revision 1.19 (requested b...

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

details:   https://anonhg.NetBSD.org/src/rev/af1bd46ec766
branches:  netbsd-1-6
changeset: 528475:af1bd46ec766
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jul 20 02:31:29 2002 +0000

description:
Pull up revision 1.19 (requested by scottr in ticket #525):
This is a complete refit of the mac68k documentation.
Of particular note is documentation on the new preferred method of
installation using sysinst, provided (and updated) by Bob Nestor.

diffstat:

 distrib/notes/mac68k/xfer |  81 ++++++++++++++++++++++++++++++++--------------
 1 files changed, 56 insertions(+), 25 deletions(-)

diffs (115 lines):

diff -r 9c91e4ad032e -r af1bd46ec766 distrib/notes/mac68k/xfer
--- a/distrib/notes/mac68k/xfer Sat Jul 20 02:31:21 2002 +0000
+++ b/distrib/notes/mac68k/xfer Sat Jul 20 02:31:29 2002 +0000
@@ -1,47 +1,69 @@
-.\"    $NetBSD: xfer,v 1.17.2.1 2002/07/02 04:20:10 lukem Exp $
+.\"    $NetBSD: xfer,v 1.17.2.2 2002/07/20 02:31:29 lukem Exp $
 .
-Installation is currently only supported from the local Macintosh hard
-drive, from a CD-ROM, or from an AppleShare volume (however, you may upgrade
-a system from within
-.Nx
-; see the section on upgrading for more details).
+There are currently two installation methods available for initial
+installation of NetBSD on Apple Macintosh 68000-based systems. Neither
+supports all installation media types at this time, so the one you select
+must be compatible with the media you have available on your system.
+.(bullet
+The
+.Ic sysinst
+method of installation uses an Installation Kernel which
+is a minimal NetBSD system with a memory resident set of utilities
+that are capable of partitioning the disk, initializing the file systems,
+and loading them from the archive files.  Since the installation
+kernel does not currently support access to Mac OS HFS file systems this
+method requires that the Binary Distribution Sets be accessible from
+CD-ROM, remote NFS partition, or via FTP access.
+.It
+The Traditional method of installation uses Mac OS hosted utilities
+to partition your disk, initialize the partitions for use by NetBSD,
+and load the file systems from archive files stored on the Mac OS HFS
+file system.  This method requires that the Binary Distribution Sets
+reside on a local Macintosh hard drive, a CD-ROM, or an AppleShare
+volume.
+.bullet)
+.Pp
+The Traditional method of installation is currently supported from the local
+Macintosh hard drive, from a CD-ROM, or from an AppleShare volume
+(however, you may ugrade a system from within NetBSD; see the
+.Sx Upgrading\ a\ previously-installed\ NetBSD\ System 
+section for more details).
 If you are installing from a local 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 15.2 MB
 .Pa base.tgz
-file.
-There has been talk of allowing an install from split files.
-If you have the time, desire, and knowledge, please feel
+file. There has been talk of allowing an install
+from split files. If you have the time, desire, and knowledge, please feel
 free to add that functionality.
 .Pp
-If the install is being done from an AppleShare-mounted volume, the install
-utility must be in the same folder as the binary distribution sets.
+If the install is being done from an AppleShare-mounted volume, the
+.Nx*M
+Installer must be in the same folder as the binary distribution sets.
 .Pp
 Each distribution file is in
 .Em raw No archive format.
 .(bullet
-Distribution files must be downloaded in binary mode.
-Common web browsers may not be suitable for this task;
-FTP clients such as Fetch and Anarchie work fine,
-but be sure to specify a binary file transfer.
+Distribution files must be downloaded in binary mode.  Common web
+browsers may not be suitable for this task; FTP clients such as
+Fetch and Anarchie work fine, but be sure to specify a binary file
+transfer.
 .It
-The files should not be unpacked.
-If you have the Internet Config
+The files should not be unpacked.  If you have the Internet Config
 extension installed, you can disable this in the
 .Dq "Helpers"
 dialog
 by removing the entry associated with
 .Dq ".tgz"
-files.
-Other FTP clients may require separate changes; consult your package's
+files.  Other FTP
+clients may require separate changes; consult your package's
 documentation.
 .It
 If you are installing from a CD-ROM, the distribution sets are
-already in the proper format and no special handling is required.
+already in the proper format. No special handling is required.
 .bullet)
 .Pp
 You will also need to collect the
-.Tn MacOS
+.Tn Mac OS
 installation tools from the
 .Pa \*M/installation/misc No subdirectory of the
 .Nx \*V
@@ -50,7 +72,16 @@
 .Nx*M
 Installer, and
 .Nx*M
-Booter.
-These three are in binhexed, self-extracting archives as Mkfs.sea.hqx,
-Installer.sea.hqx, and Booter.sea.hqx, respectively.
-Extract them as you would any other Macintosh application.
+Booter. These three are
+in BinHexed, self-extracting archives as Mkfs.sea.hqx, Installer.sea.hqx,
+and Booter.sea.hqx, respectively. Extract them as you would any other
+Macintosh application.
+.(Note
+The Booter is the only
+.Tn Mac OS
+application needed if the
+.Ic sysinst
+method of installation is used.  The Traditional method of installation
+is deprecated and will be removed in a future release, and the Mkfs and
+Installer tools will be retired.
+.Note)