[src/trunk]: src/distrib/notes By popular demand.

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

details:   https://anonhg.NetBSD.org/src/rev/bfa97a4a5499
branches:  trunk
changeset: 508654:bfa97a4a5499
user:      mbw <mbw%NetBSD.org@localhost>
date:      Mon Apr 16 20:42:43 2001 +0000

description:
By popular demand.

I've organized the topics by Open Firmware version, since many users found
the old scheme way too confusing (clause out Open Firmware version-specific
content).

It's still really confusing to read (particularly the .txt version which
doesn't adequately distinguish headings from the body)

Also added a bit more info on partitioning vs. OF version.

diffstat:

 distrib/notes/common/sysinst  |   18 +-
 distrib/notes/common/xfer     |   23 +-
 distrib/notes/macppc/hardware |   40 +-
 distrib/notes/macppc/install  |   21 +-
 distrib/notes/macppc/prep     |  590 ++++++++++++++++++++++++++++++-----------
 5 files changed, 501 insertions(+), 191 deletions(-)

diffs (truncated from 1063 to 300 lines):

diff -r f7ffa1cf461f -r bfa97a4a5499 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Mon Apr 16 20:14:04 2001 +0000
+++ b/distrib/notes/common/sysinst      Mon Apr 16 20:42:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.20 2001/04/07 18:48:09 jhawk Exp $
+.\"    $NetBSD: sysinst,v 1.21 2001/04/16 20:42:43 mbw Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -654,6 +654,7 @@
 .It
 .Em Partitioning the disk
 .(bullet
+.if !r_macppc \{\
 Which portion of the disk to use.
 .Pp
 You will be asked if you want to use the entire disk or
@@ -708,6 +709,7 @@
 .Pp
 .\}
 .It
+.\} \" !r_macppc
 .Em Editing the NetBSD disklabel
 .Pp
 The partition table of the
@@ -716,15 +718,13 @@
 .Em disklabel .
 .if r_macppc \{\
 In actuality, 
-.Nx
-uses the Apple Partition Map on your disk.  If you use
+.Nx*M
+uses the Apple Partition Map on your disk.  See 
+.Sx Partitioning your hard drive for NetBSD
+to determine whether or not you should use the
 .Nx
-to partition your drive, you will not be able to install HFS or HFS+
-partitions on your disk.  You may partition the drive using a MacOS tool,
-such as
-.Sq Drive Setup
-1.9.1 or later, however you may not be able to boot from this drive.  See
-above.
+installer to partition your disk.
+.Pp
 .\}
 .if r_sparc \{\
 .Nx
diff -r f7ffa1cf461f -r bfa97a4a5499 distrib/notes/common/xfer
--- a/distrib/notes/common/xfer Mon Apr 16 20:14:04 2001 +0000
+++ b/distrib/notes/common/xfer Mon Apr 16 20:42:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: xfer,v 1.16 2001/04/07 18:29:54 jhawk Exp $
+.\"    $NetBSD: xfer,v 1.17 2001/04/16 20:42:43 mbw Exp $
 .\"
 .\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -105,6 +105,27 @@
 .Pp
 .\} \" r_i386
 .
+.if r_macppc \{\
+You will need to have the correct bootable media prepared.
+See the section on
+.Sx Creating the Bootable Media
+for details.
+.Pp
+.(Note
+Some
+.Tn MacOS
+.Ic ftp
+clients default to downloading files in
+.Sq ASCII
+mode.  This will render the
+.Nx
+files useless.  Make sure to set your ftp program to download in
+.Sq binary
+mode.
+.Note)
+.Pp
+.\} \" r_macppc
+.
 .if r_news68k \{\
 .(Note
 .Nx*M
diff -r f7ffa1cf461f -r bfa97a4a5499 distrib/notes/macppc/hardware
--- a/distrib/notes/macppc/hardware     Mon Apr 16 20:14:04 2001 +0000
+++ b/distrib/notes/macppc/hardware     Mon Apr 16 20:42:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.7 2000/11/01 07:00:49 mbw Exp $
+.\"$NetBSD: hardware,v 1.8 2001/04/16 20:42:43 mbw Exp $
 .
 Currently,
 .Nx*M
@@ -18,7 +18,8 @@
 various quirks and problems that we must work around. The single hardest step
 of installing
 .Nx*M
-is to set up Open Firmware properly. Open Firmware versions 1.x and 2.0.x act
+is to set up Open Firmware properly. Open Firmware versions 1.0.5 and 
+2.0.x act
 similarly and the same set of instructions applies to them. Open Firmware
 version 2.4 is slightly different with regards to booting. Open Firmware
 version 3 is altogether different.
@@ -44,31 +45,16 @@
 Find your model from the list below and take note of its Open Firmware
 version:
 .(tag 8n
-.It Em "Open Firmware 1.0.5 or 2.0.x"
+.It Em "Open Firmware 1.0.5"
 .Pp
 .(bullet -compact
-Apple PowerBook (2400, 3400, G3, and G3 Series)
-.It
-Apple PowerMacintosh/Performa (4400, 54xx, 5500, 6300/160, 6360, 6400, and
-6500)
-.It
 Apple PowerMacintosh (7300, 7500 (with CPU upgrade), 7600, 8500, 8600, 9500,
 and 9600)
 .It
-Apple PowerMacintosh (G3
-.Dq Beige
-models with ATI RageII+: Desktop, Mini Tower, and All-in-One)
-.It
-APS Tech (M*Power 604e/200)
-.It
-Motorola StarMax (3000, 4000, 5000, and 5500)
-.It
 Power Computing (PowerBase, PowerCenter, PowerCenter Pro, PowerCurve,
 PowerTower, PowerTower Pro, and PowerWave)
 .It
 UMAX (J700, S900)
-.It
-UMAX (Apus 2000, Apus 3000, C500, and C600)
 .bullet)
 .It Em "Open Firmware 1.1.22"
 .Pp
@@ -83,6 +69,24 @@
 purchase and install another ethernet card in your Apple Network Server.
 .Note)
 .bullet)
+.It Em "Open Firmware 2.0.x"
+.Pp
+.(bullet -compact
+Apple PowerBook (2400, 3400, G3, and G3 Series)
+.It
+Apple PowerMacintosh/Performa (4400, 54xx, 5500, 6300/160, 6360, 6400, and
+6500)
+.It
+Apple PowerMacintosh (G3
+.Dq Beige
+models with ATI RageII+: Desktop, Mini Tower, and All-in-One)
+.It
+APS Tech (M*Power 604e/200)
+.It
+Motorola StarMax (3000, 4000, 5000, and 5500)
+.It
+UMAX (Apus 2000, Apus 3000, C500, and C600)
+.bullet)
 .It Em "Open Firmware 2.4"
 .Pp
 .(bullet -compact
diff -r f7ffa1cf461f -r bfa97a4a5499 distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Mon Apr 16 20:14:04 2001 +0000
+++ b/distrib/notes/macppc/install      Mon Apr 16 20:42:43 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.8 2000/11/04 06:08:34 mbw Exp $
+.\"    $NetBSD: install,v 1.9 2001/04/16 20:42:43 mbw Exp $
 .
 .Ss2 Booting the installer
 .
@@ -72,7 +72,8 @@
 .(bullet
 .Em Floppy disk
 .br
-(Open Firmware 1.x, Open Firmware 2.0.x)
+(Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open 
+Firmware 2.4)
 .Pp
 The floppy disk has a
 .Sq partition zero
@@ -205,12 +206,14 @@
 Here are some examples of what you might use to boot from such a drive:
 .Pp
 .Dl 0 > Ic "boot scsi/sd@0:9,ofwboot.xcf scsi/sd@0:10,netbsd"
-.Dl 0 > Ic "boot ide0/disk@0:7,ofwboot.xcf ide0/disk@0:9,ofwboot.xcf"
+.Dl 0 > Ic "boot ide0/disk@0:7,ofwboot.xcf ide0/disk@0:9,netbsd"
 .Dl 0 > Ic "boot hd:8,ofwboot.xcf ultra1:3,netbsd"
 .bullet)
 .
 .Ss2 Common Problems and Error Messages
-See the
+.
+This is a brief list of some of the Open Firmware problems you may run 
+into.  See the
 .Nx*M
 FAQ for a thorough list.
 .Lk http://www.netbsd.org/Ports/macppc/faq.html
@@ -283,7 +286,7 @@
 turn your brightness back up.
 .Pp
 Otherwise, you need a serial console. See the section entitled
-.Sx Getting to the Open Firmware Prompt
+.Sx Getting to the Open Firmware Prompt on Older Models
 .It
 Grey screen with flashing question mark
 .Pp
@@ -324,6 +327,14 @@
 .Lk http://www.netbsd.org/Ports/macppc/faq.html#pciide-lost-interrupt
 .bullet)
 .
+.Ss2 Milestone
+.
+If you've reached this point, then you must've gotten the 
+.Nx 
+installer to boot.  Congratulations!  That was the hard part.  From now 
+through the rest of this document, there should be no more Open Firmware 
+specific problems, so read everything because it applies to all models.
+.
 .so ../common/sysinst
 .
 Now, you can reboot to get to the Open Firmware prompt.  Once there, you
diff -r f7ffa1cf461f -r bfa97a4a5499 distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Mon Apr 16 20:14:04 2001 +0000
+++ b/distrib/notes/macppc/prep Mon Apr 16 20:42:43 2001 +0000
@@ -1,8 +1,38 @@
-.\"    $NetBSD: prep,v 1.10 2000/11/04 14:06:24 wiz Exp $
+.\"    $NetBSD: prep,v 1.11 2001/04/16 20:42:43 mbw Exp $
+.
+.Ss2 Gather Information
+.
+Go to the
+.Nx*M
+Model Support webpage and look up your system. Take note of the comments
+about your model and keep these in mind during the rest of this 
+installation
+procedure.
+.Lk http://www.netbsd.org/Ports/macppc/models.html
+.Pp
+Also, you 
+.Em must
+know what version of Open Firmware is in the machine you will be 
+installing
+.Nx*M
+onto.  The instructions that follow will make absolutely no sense
+if you follow directions for a version of Open Firmware other than
+the one on your machine.
+.Pp
+If the instructions in a subsection below do not apply to 
+.Em all
+versions of Open Firmware, there will be a line listing which versions of
+Open Firmware they apply to, such as:
+.br
+(Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open 
+Firmware 2.4, Open Firmware 3)
 .
 .Ss2 Open Firmware System Preparation
 .
-Most \*M systems have Open Firmware bugs. Luckily, Open Firmware has a small
+(Open Firmware 1.0.5, Open Firmware 2.0.x, Open Firmware 2.4)
+.Pp
+All pre-Open Firmware 3 \*M systems have Open Firmware bugs. Luckily, Open 
+Firmware has a small
 Non-Volatile RAM variable (NVRAM) which is reserved for FORTH commands which
 will be run before booting an operating system. Apple has released a freeware
 .Tn MacOS
@@ -10,7 +40,10 @@
 most of these bugs. We
 .Em strongly
 recommend that you use this tool to patch your Open Firmware,
-as several systems cannot boot without these patches.
+as several systems cannot boot without these patches.  If you read
+the Model Support page, you'd also know that some models are broken by
+or are unsupported by System Disk.  If you are trying to install on such
+a model, then skip the rest of this section.
 .Pp
 Download System Disk from Apple's site:
 .Lk ftp://ftp.apple.com/developer/macosxserver/utilities/SystemDisk2.3.1.smi.bin
@@ -32,6 +65,8 @@
 .
 .Ss2 Updating your firmware
 .
+(Open Firmware 3)
+.Pp
 Open Firmware 3 systems have a rewritable firmware. Go to the
 .Sq Apple Software Updates
 web site at
@@ -39,29 +74,127 @@
 and search for
 .Sq firmware
 and install the most recent version for your model.
+.Pp
+.(Note
+The most recent versions available (4.1.7 and 4.1.8) as of April 2001 are
+known to have some problems.  Some PowerBook G4 users find they are
+unable to boot 
+.Nx
+after upgrading, and 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
+.Note)