[src/netbsd-1-6]: src/distrib/notes/common Pullup rev 1.64-1.66 (requested by...

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

details:   https://anonhg.NetBSD.org/src/rev/62b125503600
branches:  netbsd-1-6
changeset: 530922:62b125503600
user:      jmc <jmc%NetBSD.org@localhost>
date:      Tue Oct 21 06:34:05 2003 +0000

description:
Pullup rev 1.64-1.66 (requested by mbw in ticket #1475)

Substantianal overhaul of install notes for macppc

diffstat:

 distrib/notes/common/sysinst |  81 ++++++++++++++++++++++++++-----------------
 1 files changed, 48 insertions(+), 33 deletions(-)

diffs (228 lines):

diff -r d67b822fc265 -r 62b125503600 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Tue Oct 21 06:33:50 2003 +0000
+++ b/distrib/notes/common/sysinst      Tue Oct 21 06:34:05 2003 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.32.2.22 2003/06/19 02:19:21 grant Exp $
+.\"    $NetBSD: sysinst,v 1.32.2.23 2003/10/21 06:34:05 jmc Exp $
 .\"
 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -414,7 +414,7 @@
 .if \n[cats] 8 MB
 .if \n[i386] 4 MB
 .if \n[mac68k] 8 MB
-.if \n[macppc] 8 MB
+.if \n[macppc] 16 MB
 .if \n[mvme68k] 4 MB
 .if \n[news68k] 4 MB
 .if \n[newsmips] 16 MB
@@ -632,7 +632,20 @@
 Go back to the main menu.
 .It
 Choose
-.Me install .
+.if !\n[macppc] .Me install .
+.if \n[macppc] \{\
+.Me "Utility menu" No then Me "Run /bin/sh"
+for Open Firmware 3 systems.  You'll need to create the 
+.Nx
+filesystem(s) and an
+.Pa fstab .
+Now exit the shell, return to the main menu, and choose
+.Me "Re-install" .
+.Pp
+Choose
+.Me install
+for Open Firmware 1.0.5, 1.1.22, 2.0.x, and 2.4 systems.
+.\}
 .It
 You will be guided through some steps regarding the
 setup of your disk, and the selection of distributed components
@@ -701,7 +714,7 @@
 .\}
 .if \n[macppc] \{\
 Further information can be found on
-.Lk http://www.netbsd.org/Ports/macppc/x11.html
+.Lk http://www.NetBSD.org/Ports/macppc/x11.html
 .\}
 .bullet)
 .bullet)
@@ -759,7 +772,7 @@
 Please see the
 .Nx*M
 FAQ at
-.Lk http://www.netbsd.org/Ports/mac68k/faq/
+.Lk http://www.NetBSD.org/Ports/mac68k/faq/
 for more information.
 .tag)
 .Pp
@@ -790,7 +803,7 @@
 menu.
 .Pp
 If the system does not come up, send mail to
-.Mt port-mac68k%netbsd.org@localhost
+.Mt port-mac68k%NetBSD.org@localhost
 describing your software, your hardware, and as complete a description of
 the problem as you can.
 As an alternative, try using the Traditional
@@ -974,14 +987,12 @@
 .\}
 .if \n[macppc] \{\
 .It
-.To 2 "Preparing a disk for Mac OS and NetBSD"
-.Em "Preparing a disk which will be used for"
-.Tn Mac OS
-.Em and NetBSD
+.To 2 "Preparing a disk for Open Firmware 3 systems"
+.Em "Preparing a disk which will be used for Open Firmware 3 systems"
 .Pp
 Skip this step if you are installing
 .Nx
-onto a dedicated drive.
+on an Open Firmware 1 or 2 system.
 .Pp
 Go to the
 .Me "Utility Menu" ,
@@ -991,8 +1002,7 @@
 From this shell prompt, you will do some of the steps that the normal
 install procedure runs automatically.
 Unfortunately, at the moment, our install tools
-aren't smart enough to deal with drives shared with
-.Tn Mac OS
+aren't smart enough to deal with drives with Apple Partition Maps
 and will overwrite important information describing your partitions.
 .Pp
 You may need to type one of the following commands to get your delete key
@@ -1005,8 +1015,9 @@
 with the name of your destination hard drive):
 .Dl # Ic "disklabel wd0"
 .Pp
-This will print out the partition info that was generated by Drive Setup.
-Note that, as discussed above in the
+This will print out the partition info that was generated by 
+.Ic pdisk ,
+Drive Setup, or Disk Utility.  Note that, as discussed above in the
 .Sx Partitioning your hard drive for NetBSD
 section, your
 .Em "A/UX Root"
@@ -1041,7 +1052,8 @@
 will be using.
 .Pp
 .Em "Do not modify any partitions labeled"
-.Pa HFS
+.Pa HFS ,
+.Pa UFS ,
 .Em or
 .Pa unknown .
 The partitions you will be using have their
@@ -1056,9 +1068,9 @@
 partitions:
 .(disp
 .Dl # Ic "newfs /dev/wd0a"
-newfs: /dev/sd1a: not a character-special device
+newfs: /dev/wd0a: not a character-special device
 Warning: 120 sector(s) in last cylinder unallocated
-/dev/sd1a:      426612 sectors in 827 cylinders of 4 tracks, 129 sectors
+/dev/wd0a:      426612 sectors in 827 cylinders of 4 tracks, 129 sectors
         208.3MB in 52 cyl groups (16 c/g, 4.03MB/g, 1024 i/g)
 super-block backups (for fsck -b #) at:
      32,   8432,  16832,  25232,  33056,  41456,  49856,  58256,  66080,
@@ -1068,7 +1080,7 @@
  297248, 305648, 314048, 322448, 330272, 338672, 347072, 355472, 363296,
  371696, 380096, 388496, 396320, 404720, 413120, 421520,
 newfs: ioctl (WDINFO): Invalid argument
-newfs: /dev/sd1a: can't rewrite disk label
+newfs: /dev/wd0a: can't rewrite disk label
 .disp)
 You can ignore the
 .Pa Sq "not a character-special device" ,
@@ -1100,6 +1112,8 @@
 to erase everything on the current line, or
 .Key CONTROL-C
 to cancel the file creation, so you can start over.
+.Key CONTROL-D
+finishes and writes the file to disk.
 .Pp
 Great, now create the mountpoints for the file systems you listed in the
 .Pa fstab :
@@ -1107,7 +1121,8 @@
 .Pp
 Clean up and return to
 .Ic sysinst :
-.Dl # Ic "cd /;umount /mnt"
+.Dl # Ic "cd /"
+.Dl # Ic "umount /mnt"
 .Dl # Ic exit
 .\}
 .It
@@ -1118,7 +1133,7 @@
 .if \n[macppc] \{\
 installation onto a dedicated
 .Nx
-drive,
+drive (Open Firmware 1 or 2),
 .\}
 .if !\n[macppc] installation,
 select
@@ -1130,10 +1145,8 @@
 from the main menu.
 .\}
 .if \n[macppc] \{\
-To start the installation onto a drive which will
-also be used with
-.Tn Mac OS ,
-select
+To start the installation onto a drive with an Apple Partition Map (Open 
+Firmware 3), select
 .Me Re-install sets or install additional sets
 from the main menu.
 .\}
@@ -1214,7 +1227,7 @@
 .Dl "I can not find any hard disk for use by NetBSD"
 or the drive you wish to install onto is missing, then you should look at
 the FAQ entry
-.Lk http://www.netbsd.org/Ports/macppc/faq.html#nodisk
+.Lk http://www.NetBSD.org/Ports/macppc/faq.html#nodisk
 .\}
 .\}
 .It
@@ -1267,11 +1280,10 @@
 .Pp
 You can skip a few steps, down to
 .Em Sq "Getting the distribution sets" ,
-if you are installing onto a drive that will be used with
-.Tn Mac OS
-(i.e. you selected
+if you are installing onto a drive with an Apple Partition Map (Open 
+Firmware 3), i.e. you selected
 .Me "Re-install sets or install additional sets"
-from the main menu).
+from the main menu.
 .\} \" \n[macppc]
 .if \n[sgimips] \{\
 .(bullet
@@ -1529,10 +1541,12 @@
 uses an Apple Partition Map.
 The installer creates something like a real
 Apple Partition Map, but it is not compatible with
-.Tn Mac OS ,
+.Tn Mac OS 
+or Open Firmware,
 which is one of the reasons why you cannot use this installer to partition
 a disk that can be used with
-.Tn Mac OS .
+.Tn Mac OS
+or Open Firmware 3 systems.
 .Pp
 .\}
 .if \n[sparc] \{\
@@ -1966,7 +1980,8 @@
 .Dl # Ic "mount /dev/wd0a /mnt"
 .Dl # Ic "cd /mnt/dev"
 .Dl # Ic "sh MAKEDEV all"
-.Dl # Ic "cd /;umount /mnt"
+.Dl # Ic "cd /"
+.Dl # Ic "umount /mnt"
 .Dl # Ic "exit"
 .\}
 .It