[src/netbsd-1-5]: src/distrib/notes/common Pullup 1.13 and 1.14 [mbw] and 1.1...

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

details:   https://anonhg.NetBSD.org/src/rev/58e5f952d810
branches:  netbsd-1-5
changeset: 490126:58e5f952d810
user:      tv <tv%NetBSD.org@localhost>
date:      Fri Nov 03 20:34:05 2000 +0000

description:
Pullup 1.13 and 1.14 [mbw] and 1.15 [releng]:
tsubai-san says that macppc doesn't suffer from install-related
pcmcia interrupt problems.  removed those for macppc
=====
added macppc- and sparc-specific conditionals and included a few important
details about each

diffstat:

 distrib/notes/common/sysinst |  119 +++++++++++++++++++++++++++++++++++-------
 1 files changed, 97 insertions(+), 22 deletions(-)

diffs (283 lines):

diff -r 0a5780b87052 -r 58e5f952d810 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Fri Nov 03 20:32:35 2000 +0000
+++ b/distrib/notes/common/sysinst      Fri Nov 03 20:34:05 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.5.4.2 2000/11/01 03:48:00 tv Exp $
+.\"    $NetBSD: sysinst,v 1.5.4.3 2000/11/03 20:34:05 tv Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -57,7 +57,7 @@
 Do not let this discourage you, the install program is not hard
 to use.
 .
-.if !\n[news68k]:\n[pmax]:\n[x68k] \{\
+.if !\n[macppc]:\n[news68k]:\n[pmax]:\n[sparc]:\n[x68k] \{\
 .It
 .Em Possible Tn PCMCIA Em issues
 .Pp
@@ -221,7 +221,7 @@
 .Nx
 release.
 .\} \" r_i386
-.\} \" ! \[news68k]:\n[pmax]:\n[x68k]
+.\} \" ! \n[macppc]:\[news68k]:\n[pmax]:\n[x68k]
 .It
 .Em General
 .Pp
@@ -256,7 +256,8 @@
 .if !r_pmax \{\
 .It
 .ie r_alpha Two floppy disks.
-.ie r_i386 Two 1.44 MB 3.5" floppy disks.
+.el .ie r_i386 Two 1.44 MB 3.5" floppy disks.
+.el .ie \n[macppc]:\n[sparc] Some form of bootable media, described above.
 .el One 1.44 MB 3.5" floppy.
 .\} \" ! r_pmax
 .if r_i386 \{\
@@ -265,20 +266,24 @@
 .\} \" r_i386
 .It
 A CD-ROM drive
-.ie \n[alpha]:\n[i386] (SCSI or ATAPI),
+.ie \n[alpha]:\n[i386]:\n[macppc] (SCSI or ATAPI),
 .el (SCSI),
 a harddisk and a minimum of
 .if r_alpha 32 MB
 .if r_i386 4 MB
+.if r_macppc 8 MB
 .if r_news68k 4 MB
 .if r_pmax 8 MB
+.if r_sparc 4 MB
 of memory installed.
 .It
 The harddisk should have at least
 .if r_alpha 200
 .if r_i386 70
+.if r_macppc 200
 .if r_news68k 100
 .if r_pmax 200
+.if r_sparc 200
 +
 .Em n
 megabytes of
@@ -333,12 +338,12 @@
 .It
 The Quick Installation
 .(bullet
-.ie r_pmax \{\
-Boot the system as desribed in the previous section.  You
+.ie \n[macppc]:\n[pmax]:\n[sparc] \{\
+Boot the system as desribed above.  You
 should be at the
 .Ic sysinst
 main menu.
-.\} \" r_pmax
+.\} \" \n[macppc]:\n[pmax]:\n[sparc]
 .el \{\
 Insert the
 .ie r_i386 first
@@ -384,9 +389,22 @@
 .It
 After all the files have been unpacked, go back to
 the main menu and select
+.ie \n[macppc]:\n[pmax]:\n[sparc] \{\
+.Me reboot.
+.\}
+.el \{\
 .Me reboot ,
 after you have removed the bootfloppy from the drive.
+.\}
 .It
+.if r_macppc \{\
+Once the system reaches the Open Firmware prompt, you will need to type
+the correct command to boot from your hard drive.
+.\}
+.if r_sparc \{\
+Once the system reaches the PROM prompt, you will need to type the correct
+command to boot from your hard drive.
+.\}
 .Nx
 will now boot. You should log in as
 .Li root ,
@@ -399,31 +417,64 @@
 .It
 For configuring the X window system, if installed, see the files in
 .Pa /usr/X11R6/lib/X11/doc .
+.if !\n[macppc]:\n[sparc] \{\
 Further information can be found on
 .Lk http://www.xfree86.org/
+.\}
 .bullet)
 .bullet)
 .It
 .Em Booting NetBSD
 .
 .
-.ie r_pmax \{\
-.Pp
-Boot the system as desribed in the previous section.
-.\}
-.el \{\
-.if !\n[news68k]:\n[x68k] \{\
+.if !\n[macppc]:\n[news68k]:\n[pmax]:\n[sparc]:\n[x68k] \{\
 .(pcmcia
 Unplug your
 .Tn PCMCIA
 devices, so that they won't be found by
 .Nx .
 .pcmcia)
-.\} \" !\n[news68k]:\n[x68k]
+.\} \" !\n[macppc]:\n[news68k]:\n[pmax]:\n[sparc]:\n[x68k]
+.ie \n[macppc]:\n[pmax]:\n[sparc] \{\
+.Pp
+Boot the system as desribed in the previous section.
+.Pp
+You may want to read the
+boot messages, to notice your disk's name and geometry. Its name
+will be something like
+.Li sd0
+.if r_macppc \{\
+or
+.Li wd0
+.\}
+and the geometry will be
+printed on a line that begins with its name. As mentioned above,
+you may need your disk's geometry when creating
+.Nx 's
+partitions.
+You will also need to know the name, to tell
+.Ic sysinst
+on which disk
+to install.
+The most important thing to know is that
+.if r_macppc \{\
+.Li wd0
+is
+.Nx 's
+name for your first IDE disk,
+.Li wd1
+the second, etc.
+.\}
+.Li sd0
+is your first SCSI disk,
+.Li sd1
+the second, etc.
+.\}
+.el \{\
 .
 .
 .Pp
-Boot your machine using the boot floppy. The boot loader will
+Boot your machine. The boot loader will
 start, and will print a countdown and begin booting.
 .Pp
 If the boot loader messages do not appear in a reasonable
@@ -499,12 +550,12 @@
 It will also include instructions for using the menus.
 .It
 .Em Network configuration
-.if !\n[news68k]:\n[pmax]:\n[x68k] \{\
+.if !\n[macppc]:\n[news68k]:\n[pmax]:\n[sparc]:\n[x68k] \{\
 .(pcmcia
 You can skip this section, as you will only get data
 from floppy in the first part of the install.
 .pcmcia)
-.\} \" ! \n[news68k]:\n[pmax]:\n[x68k]
+.\} \" ! \n[macppc]:\n[news68k]:\n[pmax]:\n[sparc]:\n[x68k]
 .Pp
 If you will not use network operation during the installation,
 but you do want your machine to be configured for networking once
@@ -536,7 +587,7 @@
 .Li rz1
 .\}
 .el \{\
-.if \n[alpha]:\n[i386] \{\
+.if \n[alpha]:\n[i386]:\n[macppc] \{\
 .Li wd0 ,
 .Li wd1 ,
 .\}
@@ -551,6 +602,7 @@
 if any, and will give you a chance to change them.
 .\}
 .Pp
+.if r_i386 \{\
 Next, depending on whether you are using a
 .Li wd Ns Ar X
 or
@@ -576,6 +628,7 @@
 that it does, reply affirmatively. Otherwise, the install
 program will automatically reserve space for bad144 tables.
 .\}
+.\}
 .It
 .Em Partitioning the disk
 .(bullet
@@ -588,13 +641,13 @@
 it will be checked if there are already other
 systems present on the disk, and you will be asked to confirm
 whether you want to overwrite these.
+.if r_i386 \{\
 .Pp
 If you want to use the entire disk for
 .Nx ,
 you can skip
 the following section and go to
 .Em "Editing the NetBSD disklabel" .
-.if r_i386 \{\
 .It
 .Em "Editing the Master Boot Record"
 .Pp
@@ -639,6 +692,25 @@
 .Nx
 part of a disk is called a
 .Em disklabel .
+.if r_macppc \{\
+In actuality, 
+.Nx
+uses the Apple Partition Map on your disk.  If you use
+.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.
+.\}
+.if r_sparc \{\
+.Nx
+disklabels on \*M are compatible with the boot ROMs, and with 
+.Tn SunOS
+and
+.Tn Solaris .
+.\}
 There are 3 layouts for the
 .Nx
 part of the disk that you can pick from:
@@ -818,7 +890,8 @@
 The sets can be made available in a few different ways. The
 following sections describe each of those methods. After
 reading the one about the method you will be using, you
-can continue to section 9
+can continue to section labeled
+.Sq Extracting the distribution sets
 .It
 .Em Installation using ftp
 .Pp
@@ -899,7 +972,7 @@
 need to specify the device that the file system resides
 on
 .ie r_pmax .Pq for example Li rz1e
-.el .Pq for example Li wd1e
+.el .Pq for example Li sd1e
 the type of the file system,
 and the directory on the specified file system where the sets are located.
 .Ic sysinst
@@ -943,5 +1016,7 @@
 .Pp
 Congratulations, you have successfully installed
 .Nx \*V .
+.if !r_macppc \{\
 You can now reboot the machine, and boot from harddisk.
+.\} \" !r_macppc
 .enum)