[src/trunk]: src/distrib/notes/macppc added "" around various tags (.Em, .Sq, ...

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

details:   https://anonhg.NetBSD.org/src/rev/a869dbc75c0d
branches:  trunk
changeset: 510188:a869dbc75c0d
user:      mbw <mbw%NetBSD.org@localhost>
date:      Tue May 22 04:09:41 2001 +0000

description:
added "" around various tags (.Em, .Sq, .Li) that were missing.
this cleans up the HTML version a lot.

macppc/hardware
doubled required RAM -- bootloader needs 16 MB to be present
reworded video section -- 9500 shipped with PCI card, not on-board video

diffstat:

 distrib/notes/macppc/hardware |   19 ++++---
 distrib/notes/macppc/install  |   24 +++++-----
 distrib/notes/macppc/prep     |  100 +++++++++++++++++++++--------------------
 3 files changed, 73 insertions(+), 70 deletions(-)

diffs (truncated from 544 to 300 lines):

diff -r 562235fd96be -r a869dbc75c0d distrib/notes/macppc/hardware
--- a/distrib/notes/macppc/hardware     Tue May 22 03:22:49 2001 +0000
+++ b/distrib/notes/macppc/hardware     Tue May 22 04:09:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"$NetBSD: hardware,v 1.12 2001/05/19 05:43:29 mbw Exp $
+.\"$NetBSD: hardware,v 1.13 2001/05/22 04:09:41 mbw Exp $
 .
 Currently,
 .Nx*M
@@ -39,12 +39,12 @@
 .Nx
 will run on this system.
 .Pp
-The minimal configuration requires 8 MB of RAM and ~80 MB of disk space.
+The minimal configuration requires 16 MB of RAM and ~80 MB of disk space.
 To install the entire system requires much more disk space, and to run
 X or compile the system, more RAM is recommended, as
 .Nx
-with 8 MB of RAM is very slow. Note that until you have
-around 16 MB of RAM, getting more RAM is more important than getting a
+with 16 MB of RAM is very slow. Note that until you have
+around 32 MB of RAM, getting more RAM is more important than getting a
 faster CPU.
 .
 .Ss2 Supported models
@@ -298,8 +298,9 @@
 Several models have been reported to not work with
 .Nx
 if the on-board video is in use, such as the Performa 54xx, 6360, 6400,
-PowerMacintosh 9500/150, 9500/180, 9500/200, PowerComputing PowerTower, and
-UMAX C600 and Apus 3000
+PowerComputing PowerTower, and UMAX C600 and Apus 3000.  Also, the video
+card that shipped with the PowerMacintosh 9500/150, 9500/180, and 9500/200
+systems is reported to have the same problem.
 .Note)
 .Pp
 .It
@@ -423,14 +424,14 @@
 .
 Each version of Open Firmware supports different devices and media that you
 may boot from.  We define the terms
-.Dq bootable media
+.Dq "bootable media"
 as the media (hard drive, CD-R, ethernet) that will be used to bootstrap
 your \*M system into
 .Nx No Ns ,
 and
-.Dq distribution sets
+.Dq "distribution sets"
 or
-.Dq distribution media
+.Dq "distribution media"
 as the media (hard drive, CD-R, ethernet) that contains the files that
 will be installed to generate a working 
 .Nx
diff -r 562235fd96be -r a869dbc75c0d distrib/notes/macppc/install
--- a/distrib/notes/macppc/install      Tue May 22 03:22:49 2001 +0000
+++ b/distrib/notes/macppc/install      Tue May 22 04:09:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: install,v 1.12 2001/05/19 05:43:29 mbw Exp $
+.\"    $NetBSD: install,v 1.13 2001/05/22 04:09:41 mbw Exp $
 .
 .Ss2 Booting the installer
 .
@@ -23,7 +23,7 @@
 .Li kernel_location
 is either a filename if the kernel is on the same partition as the
 bootloader, or another complete
-.Sq Li device:partition,filename .
+.Sq Li "device:partition,filename" .
 And, there's no reason (other than Open Firmware bugginess) that you can't
 specify an entirely different device for the kernel.
 For instance, you could have a
@@ -86,13 +86,13 @@
 .
 Here are some examples of the commands you might use to boot your system:
 .(bullet
-.Em Floppy disk
+.Em "Floppy disk"
 .br
 (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
+.Sq "partition zero"
 bootloader. 
 .(Note
 This is not a normal
@@ -119,7 +119,7 @@
 Or you may be more specific,
 specifying the bootloader filename and the kernel name:
 .Pp
-.Dl 0 > Ic boot "enet:,ofwboot.xcf enet:,netbsd.ram.gz"
+.Dl 0 > Ic "boot enet:,ofwboot.xcf enet:,netbsd.ram.gz"
 .(Note
 Some Open Firmware 1.0.5 machines do not retrieve the BOOTP information
 correctly. These machines cannot netboot.
@@ -136,7 +136,7 @@
 Or you may be more specific,
 specifying the bootloader filename and the kernel name:
 .Pp
-.Dl 0 > Ic boot "enet:0,ofwboot.xcf enet:0,netbsd.ram.gz"
+.Dl 0 > Ic "boot enet:0,ofwboot.xcf enet:0,netbsd.ram.gz"
 .It
 .Em CD-ROM
 .br
@@ -189,15 +189,15 @@
 .Dl 0 > Ic "boot ide1/disk@0:0,OFWBOOT.XCF NETBSD.RAM"
 .Dl 0 > Ic "boot cd:0,OFWBOOT.XCF NETBSD.RAM"
 .It
-.Em IDE or SCSI drive with a
-.Sq partition zero
+.Em "IDE or SCSI drive with a"
+.Sq "partition zero"
 bootloader
 .br
 (Open Firmware 1.0.5, Open Firmware 1.1.22, Open Firmware 2.0.x, Open
 Firmware 2.4)
 .Pp
 You do not specify a file to load, since the
-.Sq partition zero
+.Sq "partition zero"
 booloader knows what to do. You would boot such a system if you have dumped
 the boot floppy image to your drive, or if you have an already-installed
 .Nx*M
@@ -216,7 +216,7 @@
 .Dl 0 > Ic "boot ide0/disk@0:0"
 .Dl 0 > Ic "boot zip:0"
 .It
-.Em IDE or SCSI drive from an HFS or HFS+ partition
+.Em "IDE or SCSI drive from an HFS or HFS+ partition"
 .br
 (Open Firmware 2.4, Open Firmware 3)
 .Pp
@@ -478,7 +478,7 @@
 .Nx
 from the media of your choice.  First, make sure you know what command you
 need to boot (see above).  If you are using a 
-.Sq partition zero
+.Sq "partition zero"
 style boot scheme, you would type something like the following:
 .Pp
 .Dl 0 > Ic "setenv auto-boot? true"
@@ -496,7 +496,7 @@
 .Dl 0 > Ic "setenv boot-command begin ['] boot catch 1000 ms cr again"
 .Pp
 If you are not using a
-.Sq partition zero
+.Sq "partition zero"
 style boot scheme, then you can still plug in all the information you
 need:
 .Pp
diff -r 562235fd96be -r a869dbc75c0d distrib/notes/macppc/prep
--- a/distrib/notes/macppc/prep Tue May 22 03:22:49 2001 +0000
+++ b/distrib/notes/macppc/prep Tue May 22 04:09:41 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: prep,v 1.16 2001/05/19 05:43:29 mbw Exp $
+.\"    $NetBSD: prep,v 1.17 2001/05/22 04:09:41 mbw Exp $
 .
 .Ss2 Prepare yourself
 .
@@ -101,7 +101,7 @@
 (Open Firmware 3)
 .Pp
 Open Firmware 3 systems have a rewritable BootROM. Go to the
-.Sq Apple Software Updates
+.Sq "Apple Software Updates"
 web site at
 .Lk http://asu.info.apple.com/
 and search for
@@ -164,7 +164,7 @@
 Apple Network Servers can only use a serial console.
 You must first hook up a serial console
 (38400 bps, 8 bits, no parity, 1 stop bit, no handshaking) to 
-.Sq Port 2
+.Sq "Port 2"
 (the
 .Sq Li ttya
 device in Open Firmware).
@@ -240,7 +240,7 @@
 button, or the patches will not be saved to NVRAM.
 .(Note
 NVRAM patches and Open Firmware settings will be erased if you
-.Sq zap your PRAM
+.Sq "zap your PRAM"
 by holding down
 .Key COMMAND-OPTION-P-R
 keys during the boot chimes, or if you accidentally boot into 
@@ -339,7 +339,7 @@
 (38400 bps, 8 bits, no parity, 1 stop bit, no handshaking).
 .(Note
 The
-.Dq Stop Boot at Open Firmware prompt
+.Dq "Stop Boot at Open Firmware prompt"
 setting is persistent.  It is equivalent to the Open Firmware command
 .Pp
 .Dl 0 > Ic "setenv auto-boot? false
@@ -395,7 +395,7 @@
 BootVars tool.  Click on the
 .Dq auto-boot?
 checkbox, then click on the
-.Dq All Variables
+.Dq "All Variables"
 checkbox and type
 .Ic kbd
 into the
@@ -666,7 +666,7 @@
 kernel.  There are two approaches, the 
 .Pa ofwboot.xcf
 bootloader and the
-.Sq partition zero
+.Sq "partition zero"
 bootloader.  In the former case, the user tells Open Firmware to
 load
 .Pa ofwboot.xcf
@@ -762,7 +762,7 @@
 .bullet)
 .Pp
 The boot floppy image provided with the distribution sets has a
-.Sq partition zero
+.Sq "partition zero"
 bootloader and a
 .Nx
 file system with an installation kernel.
@@ -917,7 +917,7 @@
 also be used with 
 .Tn MacOS No Ns ,
 although a disk prepared in this way 
-.Em will not boot 
+.Em "will not boot"
 .Em Nx No Ns .
 That means, your root partition
 .No ( Ns Pa / No Ns )
@@ -978,10 +978,12 @@
 systems).
 .bullet)
 .Pp
-.Em Using the 
-.Em Nx installer to install a disklabel or bootloader will
-.Em render your disk unusable by Tn MacOS No Ns .
-.Em Either will also prevent Open Firmware 3 machines from booting
+.Em "Using the"
+.Em Nx 
+.Em "installer to install a disklabel or bootloader will"
+.Em "render your disk unusable by"
+.Tn MacOS No Ns .
+.Em "Either will also prevent Open Firmware 3 machines from booting"
 .Pa ofwboot.xcf Ns .
 .Pp
 Unfortunately, the partitioning tools for
@@ -1002,7 +1004,7 @@
 as you desire for 
 .Tn MacOS
 usage.
-.It Em A/UX Root
+.It Em "A/UX Root"
 Must be at least 20 MB. Alternatively, you may decide to use one partition for
 your entire
 .Nx
@@ -1010,24 +1012,24 @@
 MB with X.
 .Nx
 interprets an
-.Em A/UX Root
+.Em "A/UX Root"
 partition as the first partition 
 .No ( Ns Em a No Ns )
 on the disk.  
 This partition is not readable from
 .Tn MacOS No Ns .
-.It Em A/UX Swap
+.It Em "A/UX Swap"
 Any size. The recommenation is 1.5 times your RAM, although this is not
 strictly necessary for machines with a lot of RAM.
 .Nx
 interprets an
-.Em A/UX Swap
+.Em "A/UX Swap"
 partition as the second partition
 .No ( Ns Em b No Ns )
 on the disk.
 This partition is not readable from
 .Tn MacOS No Ns .
-.It Em A/UX User, A/UX Free1, A/UX Free2, A/UX Free3
+.It Em "A/UX User, A/UX Free1, A/UX Free2, A/UX Free3"
 Use these for any additional partitions you may want to use under
 .Nx Ns ,
 such as 
@@ -1158,12 +1160,12 @@
 which will load the installation kernel.
 .Pp
 .(bullet -compact
-.Em From a UNIX machine
+.Em "From a UNIX machine"
 .Pp
 .Dl # Ic "dd if=boot.fs of=/dev/rfd0a bs=36k"
 .Pp
 .It
-.Em From a Windows machine