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

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

details:   https://anonhg.NetBSD.org/src/rev/5dc42767f61e
branches:  netbsd-1-6
changeset: 530356:5dc42767f61e
user:      grant <grant%NetBSD.org@localhost>
date:      Thu Jun 19 01:52:38 2003 +0000

description:
Pull up revision 1.38 (requested by mbw in ticket #1307):

misc small typos and wording cleanup
fix links to newly updated Partitioning HOW-TO
OF 3 firmware update 4.1.7, mention that it's not much of a problem anymore point to ZTerm home page redo partitioning section update now that there's a pair of boot floppies
change MS-DOS floppy section to be Zip disk

diffstat:

 distrib/notes/macppc/prep |  305 +++++++++++++++++++++++++--------------------
 1 files changed, 171 insertions(+), 134 deletions(-)

diffs (truncated from 612 to 300 lines):

diff -r 7be7fff79ab3 -r 5dc42767f61e distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Thu Jun 19 01:49:57 2003 +0000
+++ b/distrib/notes/macppc/prep Thu Jun 19 01:52:38 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.27.2.8 2003/06/19 01:28:32 grant Exp $
+.\"    $NetBSD: prep,v 1.27.2.9 2003/06/19 01:52:38 grant Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -95,6 +95,10 @@
 for the first time.
 .Pp
 .It
+You may then boot into Open Firmware and set it to always boot your
+favorite operating system.
+.Pp
+.It
 Configure to your preferences, install your favorite packages, and have
 fun with your new
 .Nx*M
@@ -150,12 +154,10 @@
 We recommend not doing this.
 .Note)
 .(Note
-The most recent BootROMs available (4.1.7 and later) are
-known to have some problems.
-Some PowerMacintosh users find that their third-party
-RAM has been disabled.
-See the discussion at
-.Lk http://www.macfixit.com/archives/april.01.a.shtml#firm-04-07
+The most recent BootROMs available (4.1.7 and later) are a little picky
+about RAM.  Initially, some PowerMacintosh users found that their
+third-party RAM had been disabled, but the RAM vendors brought their RAM
+up to spec and it hasn't been much of an issue since then.
 .Pp
 There are reports that FirmWare Update 4.1.9 on iMac (Summer 2000) will
 prevent the CD-ROM and the hard drive from operating together.
@@ -319,6 +321,7 @@
 .Nx*M
 system.
 .Lk http://hyperarchive.lcs.mit.edu/HyperArchive/Archive/comm/term/zterm-101.hqx
+.Lk http://homepage.mac.com/dalverson/zterm/
 .Pp
 See the NetBSD Serial Port Primer for additional help and references:
 .Lk http://www.netbsd.org/Documentation/Hardware/Misc/serial.html
@@ -801,8 +804,8 @@
 .Em not
 able to use the
 .Nx
-file system (FFS), so we must put the bootloader in a location that Open
-Firmware is capable of using.
+file system (FFS) or Apple's new filesystem (UFS), so we must put the
+bootloader in a location that Open Firmware is capable of using.
 .Pp
 Therefore, to boot the
 .Nx
@@ -905,9 +908,12 @@
 .
 .It
 .Em "ISO9660 CD-ROM file system"
+.
+.It
+.Em "MS-DOS file system"
 .bullet)
 .Pp
-The boot floppy image provided with the distribution sets has a
+The boot floppy images provided with the distribution sets have a
 .Sq "partition zero"
 bootloader and a
 .Nx
@@ -992,7 +998,7 @@
 .Nx
 kernel from the same MS-DOS file system or elsewhere.
 This has only been thoroughly tested on floppy disks,
-but may work on FDISK-formatted hard drives.
+but may work on Zip disks or FDISK-formatted hard drives.
 This does not work for MS-DOS partitions on a hard drive with an Apple
 Partition Map.
 .Pp
@@ -1117,11 +1123,9 @@
 .It
 .Em "Open Firmware 3"
 .br
-You must have at least one disk that was partitioned using a
-.Tn MacOS
-tool before installing
+You must have at least one disk that was partitioned before running the
 .Nx
-on your system.
+installer.
 .Pp
 This is the drive that will be holding the bootloader,
 .Pa ofwboot.xcf No Ns .
@@ -1138,37 +1142,87 @@
 .Pp
 The rest of this section describes how to make a
 single disk dual-bootable which is necessary for machines which have only
-one hard drive (such as the iBook, iMac, PowerBook, and PowerMacintosh Cube
-systems).
+one hard drive (such as the eMac, iBook, iMac, PowerBook, and
+PowerMacintosh Cube systems).
 .bullet)
 .Pp
-Using the
+There are two partitioning tools available for
+.Nx*M ,
+.Xr disklabel 8
+and
+.Xr pdisk 8 .
+The former is used in the 
 .Nx
-installer to install a disklabel or bootloader will
-render your disk unusable by
+.Ic sysinst
+installer, and will render your disk unusable by
 .Tn MacOS .
-Either will also prevent Open Firmware 3 machines from booting.
-You will need to use the installer's
+It will also prevent Open Firmware 3 machines from booting from that disk.
+When running the installer, you will need to use the installer's
 .Dq Re-install sets
-option.
-More information is provided below on this process.
+option to skip
+.Ic disklabel .
+In the meantime, this section describes how to partition your disk.
+.Pp
+The process is more fully detailed in the Partitioning HOW-TO:
+.Lk http://www.netbsd.org/Ports/macppc/partitioning.html
+.Pp
+You can create a partition map with 
+.Xr pdisk 8 ,
+but the disk will not be usable with MacOS 9 and earlier.  If this is a
+concern, you will need to use Apple's Drive Setup or Disk Utility.
+.Pp
+If you are using Apple's Drive Setup tool, make sure you have version
+1.8.1 or later.  This tool only runs under MacOS 9 and earlier.  Drive
+Setup will erase the contents of your drive \(em it does not preserve data
+from any of your partitions.
 .Pp
-There are several contradictory partition numbering schemes.
-You may want to look at the explanation in the FAQ.
-.Lk http://www.netbsd.org/Ports/macppc/faq.html#partitions
-.Pp
-Unfortunately, the partitioning tools for
+Apple's Disk Utility only runs under MacOS X 10.0.0 and later.
+Make sure you click the 
+.Dq "Install Mac OS 9 Disk Drivers"
+checkbox.  Also, keep in mind that Disk Utility does
+.Em not
+create the partitions that
+.Nx*M
+requires.  After creating the initial partition map with Disk Utility, you
+will need to use the
 .Nx
-are not advanced enough to create HFS or HFS+ file systems or a
-partition map that can be shared with
-.Tn MacOS .
-You will need to use the
-.Tn MacOS
-Drive Setup tool (versions 1.8.1 and later are
-known to work) to partition the hard drive you will be using for
-.Nx .
-Drive Setup will erase the contents of your drive -- it does not preserve
-data from any of your partitions.
+.Ic pdisk
+to change the partition types.  Also, Disk Utility will erase the contents
+of your drive \(em it does not preserve data from any of your partitions.
+.Pp
+.Ic pdisk
+is the most flexible (and most difficult to use) partitioning tool
+available.
+It runs on almost all OSes that \*M machines support.  Download it:
+.Lk ftp://ftp.netbsd.org/pub/NetBSD/arch/macppc/netbsd-pdisk/
+.Lk ftp://ftp.netbsd.org/pub/NetBSD/arch/macppc/macos-utils/pdisk.sea.hqx
+.Pp
+There is built-in help describing how it works.  When it asks you to enter
+the
+.Dq Li "Type of partition" ,
+use 
+.Li Apple_UNIX_SVR2
+for 
+.Nx
+partitions,
+.Li Apple_HFS
+for HFS and HFS+ partitions, and
+.Li Apple_UFS
+for UFS partitions.
+.Pp
+After you've written the partition map with
+.Ic pdisk ,
+you will need to create the filesystems.  Use
+.Xr newfs 8
+and 
+.Xr mount 8
+for 
+.Nx
+filesystems, and 
+.Ic hfstools
+to create and mount HFS filesystems.
+.Lk ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/sysutils/hfsutils/README.html
+.Pp
 Make the following partitions:
 .(tag "A/UXxUserxandxA/UXxFree1" -offset indent
 .It Em HFS No or Em HFS+
@@ -1221,24 +1275,18 @@
 .Tn MacOS
 and
 .Nx .
-If you think you'll be doing this often, then see the FAQ entry on sharing
-files:
-.Lk http://www.netbsd.org/Ports/macppc/faq.html#disk-sharing
+If would like to create such a partition, then see the Partitioning HOW-TO.
+.Lk http://www.netbsd.org/Ports/macppc/partitioning.html#msdos
 .It Em UFS
 Any size.
 This file system type is not currently supported by
 .Nx*M
-although it might be in the future.
+although it will be in the next major release.
 .Em UFS
 partitions are not readable from
 .Tn MacOS
 versions prior to X 10.0.0.
 .tag)
-.Pp
-If you need further help, there is a partitioning HOW-TO on the
-.Nx
-website:
-.Lk http://www.netbsd.org/Ports/macppc/partitioning.html
 .
 .Ss2 Preparing the Bootable Media
 .
@@ -1284,31 +1332,31 @@
 .Em "Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x"
 .br
 .(bullet -compact
-Booting off an MS-DOS floppy
+Booting off an MS-DOS disk
 .It
 Booting off the
 .Nx
-install floppy
+install floppies
 .It
 Booting off the
 .Nx*M
 install CD-R image
 .It
-Booting off an ISO9660 CD-ROM
+Booting off a custom ISO9660 CD-R
 .It
 Booting over the ethernet
 .It
-Booting the floppy image off a SCSI or IDE drive (not recommended)
+Booting the CD-R image off a SCSI or IDE drive (not recommended)
 .bullet)
 .It
 .Em "Open Firmware 2.4"
 .br
 .(bullet -compact
-Booting off an MS-DOS floppy (may not be supported by Open Firmware 2.4)
+Booting off an MS-DOS disk (may not be supported by Open Firmware 2.4)
 .It
 Booting off the
 .Nx
-install floppy
+install floppies
 .It
 Booting off the
 .Nx*M
@@ -1316,13 +1364,13 @@
 .It
 Booting off an HFS or HFS+ partition
 .It
-Booting off an ISO9660 CD-ROM
+Booting off a custom ISO9660 CD-R
 .It
-Booting off a Hybrid HFS/ISO9660 CD-ROM
+Booting off a custom Hybrid HFS/ISO9660 CD-R
 .It
 Booting over the ethernet
 .It
-Booting the floppy image off a SCSI or IDE drive (not recommended)
+Booting the CD-R image off a SCSI or IDE drive (not recommended)
 .bullet)
 .It
 .Em "Open Firmware 3"
@@ -1334,7 +1382,7 @@
 .Nx*M
 install CD-R image
 .It
-Booting off a Hybrid HFS/ISO9660 CD-ROM
+Booting off a custom Hybrid HFS/ISO9660 CD-R
 .It
 Booting over the ethernet
 .bullet)
@@ -1346,17 +1394,21 @@
 .Pp
 .(bullet