[src/netbsd-1-6]: src/distrib/notes/common Pull up revisions 1.57-1.58 (reque...

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

details:   https://anonhg.NetBSD.org/src/rev/a02b8469612b
branches:  netbsd-1-6
changeset: 528567:a02b8469612b
user:      lukem <lukem%NetBSD.org@localhost>
date:      Mon Jul 22 17:18:14 2002 +0000

description:
Pull up revisions 1.57-1.58 (requested by lukem):

1.58:
use sh3eb or sh3el instead of sh3

1.57:
- define some useful strings and use appropriately
        \*[part_raw]    `raw' partition (usually `c' or `d')
        \*[part_free]   first "free" partition (usually part_raw+1)
        \*[part_usr]    default "/usr" partition (usually part_free)
        \*[part_max]    last partition (usually `h' or `p')
- consistently use \n[MACHINE] instead of r_MACHINE
- fix up formatting fubars on mac68k (and others)

diffstat:

 distrib/notes/common/sysinst |  273 ++++++++++++++++++++++--------------------
 1 files changed, 143 insertions(+), 130 deletions(-)

diffs (truncated from 710 to 300 lines):

diff -r 659af5f0ff64 -r a02b8469612b distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Mon Jul 22 17:16:07 2002 +0000
+++ b/distrib/notes/common/sysinst      Mon Jul 22 17:18:14 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.32.2.17 2002/07/22 05:24:52 lukem Exp $
+.\"    $NetBSD: sysinst,v 1.32.2.18 2002/07/22 17:18:14 lukem Exp $
 .\"
 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -42,6 +42,40 @@
 ..
 .
 .
+.\" Define strings for partition references:
+.\"    \*[part_raw]    `raw' partition (usually `c' or `d')
+.\"    \*[part_free]   first "free" partition (usually part_raw+1)
+.\"    \*[part_usr]    default "/usr" partition (usually part_free)
+.\"    \*[part_max]    last partition (usually `h' or `p')
+.
+.ds part_raw c
+.ds part_free d
+.ds part_usr d
+.ds part_max h
+.if \n[arc]:\n[bebox]:\n[cobalt]:\n[hpcarm]:\n[hpcmips]:\n[i386]:\
+\n[sbmips]:\n[sh3eb]:\n[sh3el]:\n[x86_64] \{\
+.  ds part_raw d
+.  ds part_free e
+.  ds part_usr e
+.\}
+.if \n[sgimips] \{\
+.  ds part_free e
+.  ds part_usr e
+.\}
+.if \n[amiga]:\n[amigappc]:\n[arc]:\n[atari]:\n[cobalt]:\n[evbmips]:\
+\n[hpcmips]:\n[i386]:\n[macppc]:\n[ofppc]:\n[playstation2]:\n[sandpoint]:\
+\n[sbmips]:\n[sgimips]:\n[walnut]:\n[x86_64] \{\
+.  ds part_max p
+.\}
+.if \n[acorn26]:\n[acorn32]:\n[cats]:\n[evbarm]:\n[pc532]:\n[sandpoint]:\
+\n[shark]:\n[walnut] \{\
+.  ds part_usr e
+.\}
+.if \n[macppc]:\n[news68k]:\n[newsmips]:\n[sparc]:\n[sparc64] \{\
+.  ds part_usr g
+.\}
+.
+.
 .Ss2 Running the sysinst installation program
 .(enum
 .To 2 Introduction
@@ -139,7 +173,7 @@
 If this problem is affecting you, watch the
 .Dq Bq Tn PCMCIA
 notes that will appear in this document.
-.if r_i386 \{\
+.if \n[i386] \{\
 .Pp
 It can be difficult to distinguish an interrupt conflict from
 an I/O space conflict.
@@ -257,9 +291,9 @@
 We hope to provide a more elegant solution to this problem in a future
 .Nx
 release.
-.\} \" r_i386
+.\} \" \n[i386]
 .\} \" !\n[acorn26]:\n[atari]:\n[macppc]:\n[mvme68k]:\n[news68k]:\n[newsmips]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut]:\n[x68k]
-.if r_mac68k \{\
+.if \n[mac68k] \{\
 .It
 .To 2 "Possible hardware-specific issues"
 .Em Possible hardware-specific issues
@@ -300,7 +334,7 @@
 Software emulation of floating point operations is
 not a problem on the 68020 and 68030 processors.
 .bullet)
-.\}
+.\} \" \n[mac68k]
 .It
 .To 2 General
 .Em General
@@ -341,17 +375,17 @@
 The distribution sets (in this example, they are on CD).
 .if !\n[pmax]:\n[sgimips] \{\
 .It
-.ie r_alpha Two floppy disks.
+.ie \n[alpha] Two floppy disks.
 .el \{\
-.ie r_i386 Two 1.44 MB 3.5" floppy disks.
+.ie \n[i386] Two 1.44 MB 3.5" floppy disks.
 .el \{\
-.ie r_mac68k The Mac OS Booter application and an Installation Kernel
+.ie \n[mac68k] The Mac OS Booter application and an Installation Kernel
 .el \{\
 .ie \n[acorn26]:\n[cats]:\n[macppc]:\n[sparc]:\n[walnut] \{\
 Some form of bootable media, described above.
 .\}
 .el \{\
-.ie r_atari \{\
+.ie \n[atari] \{\
 A floppy disk containing a suitable boot.fs and a floppy with the
 sysinst.fs image.
 See the "prepare" section about obtaining those.
@@ -359,11 +393,11 @@
 .el One 1.44 MB 3.5" floppy.
 .\}\}\}\}
 .\} \" !\n[pmax]:\n[sgimips]
-.if r_i386 \{\
+.if \n[i386] \{\
 .It
 A PC with a 386 or newer processor.
-.\} \" r_i386
-.if r_mac68k \{\
+.\} \" \n[i386]
+.if \n[mac68k] \{\
 .It
 A Macintosh with a 68020 and MMU, 68030 or 68RC040 processor.
 An FPU is not required but will be used if present
@@ -374,35 +408,35 @@
 .ie \n[acorn26]:\n[atari]:\n[alpha]:\n[cats]:\n[i386]:\n[macppc]:\n[walnut] (SCSI or ATAPI),
 .el (SCSI),
 a harddisk and a minimum of
-.if r_acorn26 8 MB
-.if r_alpha 32 MB
-.if r_atari 4 MB (TT030/Falcon) or 16 MB (Hades/Milan)
-.if r_cats 8 MB
-.if r_i386 4 MB
-.if r_mac68k 8 MB
-.if r_macppc 8 MB
-.if r_mvme68k 4 MB
-.if r_news68k 4 MB
-.if r_newsmips 16 MB
-.if r_pmax 8 MB
-.if r_sparc 4 MB
-.if r_sgimips 16 MB
+.if \n[acorn26] 8 MB
+.if \n[alpha] 32 MB
+.if \n[atari] 4 MB (TT030/Falcon) or 16 MB (Hades/Milan)
+.if \n[cats] 8 MB
+.if \n[i386] 4 MB
+.if \n[mac68k] 8 MB
+.if \n[macppc] 8 MB
+.if \n[mvme68k] 4 MB
+.if \n[news68k] 4 MB
+.if \n[newsmips] 16 MB
+.if \n[pmax] 8 MB
+.if \n[sparc] 4 MB
+.if \n[sgimips] 16 MB
 of memory installed.
 .It
 The harddisk should have at least
-.if r_acorn26 200
-.if r_alpha 200
-.if r_atari 120
-.if r_cats 200
-.if r_i386 70
-.if r_mac68k 120
-.if r_macppc 200
-.if r_mvme68k 100
-.if r_news68k 100
-.if r_newsmips 200
-.if r_pmax 200
-.if r_sparc 200
-.if r_sgimips 200
+.if \n[acorn26] 200
+.if \n[alpha] 200
+.if \n[atari] 120
+.if \n[cats] 200
+.if \n[i386] 70
+.if \n[mac68k] 120
+.if \n[macppc] 200
+.if \n[mvme68k] 100
+.if \n[news68k] 100
+.if \n[newsmips] 200
+.if \n[pmax] 200
+.if \n[sparc] 200
+.if \n[sgimips] 200
 +
 .Em n
 megabytes of
@@ -432,15 +466,15 @@
 .Dl Ic "rawrite"
 .Pp
 When asked for a source filename, answer
-.if r_i386 \{\
+.if \n[i386] \{\
 .Dl Pa \&..\efloppy\eboot1.fs
 for the first diskette and
 .Dl Pa \&..\efloppy\eboot2.fs
 for the second diskette.
 .\}
-.if r_alpha .Dl Em \&(...alpha installation root) Ns Pa \efloppy\edisk1of2
-.if r_news68k .Dl Pa \eNetBSD-\*V\e\*M\einstallation\efloppy\eboot.fs
-.if r_newsmips .Dl Pa \eNetBSD-\*V\e\*M\einstallation\efloppy\eboot.fs
+.if \n[alpha] .Dl Em \&(...alpha installation root) Ns Pa \efloppy\edisk1of2
+.if \n[news68k] .Dl Pa \eNetBSD-\*V\e\*M\einstallation\efloppy\eboot.fs
+.if \n[newsmips] .Dl Pa \eNetBSD-\*V\e\*M\einstallation\efloppy\eboot.fs
 .Pp
 When asked for a destination drive answer
 .Sq Ic a .
@@ -454,7 +488,7 @@
 .Dl # Ic "dd if=.../boot1.fs bs=18k of=/dev/rfd0a"
 .Pp
 .\} \" \n[alpha]:\n[i386]:\n[news68k]:\n[newsmips]
-.if r_mac68k \{\
+.if \n[mac68k] \{\
 .It
 The NetBSD Boot Tools folder.
 .(bullet
@@ -490,7 +524,7 @@
 main menu.
 .\}
 .el \{\
-.ie r_mac68k \{\
+.ie \n[mac68k] \{\
 Double-click on the Booter application icon to start executing it.
 From the
 .Ic Options
@@ -542,23 +576,23 @@
 .\}
 .el \{\
 Insert the first boot floppy you just created.
-.ie r_i386 Restart
+.ie \n[i386] Restart
 .el Boot
 the computer.
-.if r_alpha \{\
+.if \n[alpha] \{\
 Type
 .Pp
 .Dl \&\*>\*>\*> Ic "B DVA0"
 .Pp
 .\}
-.if r_i386 When prompted, insert the second boot floppy.
-.if r_news68k \{\
+.if \n[i386] When prompted, insert the second boot floppy.
+.if \n[news68k] \{\
 Type
 .Pp
 .Dl \&NEWS\*> Ic "bo fh"
 .Pp
 .\}
-.if r_newsmips \{\
+.if \n[newsmips] \{\
 Type
 .Pp
 .Dl \&\*> Ic "bo fd" (in case of NWS-5000)
@@ -573,6 +607,7 @@
 .(disp
 .ne 10
 . cs \n(.f 22
+.\" )   - appease vi showmatch
   .***********************************************.
   * NetBSD-1.6 Install System                     *
   *                                               *
@@ -584,6 +619,7 @@
   * x: Exit Install System                        *
   .***********************************************.
 . cs \n(.f
+.\" )   - appease vi showmatch
 .disp)
 .It
 If you wish, you can configure some network settings
@@ -602,13 +638,13 @@
 setup of your disk, and the selection of distributed components
 to install.
 When in doubt, refer to the rest of this document for details.
-.if r_atari \{\
+.if \n[atari] \{\
 WARNING: If you want your disk to retain an AHDI compatible partitioning,
 make sure to use the 'existing' disk layout.
 .\}
 .It
 After your disk has been prepared, choose
-.ie r_sgimips \{\
+.ie \n[sgimips] \{\
 .Me Unmounted file system
 as the medium.
 The CD-ROM device is usually cd0 and the partition
@@ -631,15 +667,15 @@
 after you have removed the bootfloppy from the drive.
 .\}
 .It
-.if r_macppc \{\
+.if \n[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 \{\
+.if \n[sparc] \{\
 Once the system reaches the PROM prompt, you will need to type the correct
 command to boot from your hard drive.
 .\}
-.if r_sgimips \{\
+.if \n[sgimips] \{\
 Once the system reaches the PROM prompt, you will need to modify your
 PROM environment settings for SystemPartition, OSLoadPartition, OSLoader
 and OSLoadFilename and then boot the hard drive.
@@ -798,7 +834,7 @@
 .
 .