[src/netbsd-1-6]: src/distrib/notes/common Pull up revision 1.71 (requested b...

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

details:   https://anonhg.NetBSD.org/src/rev/81007a824522
branches:  netbsd-1-6
changeset: 528569:81007a824522
user:      lukem <lukem%NetBSD.org@localhost>
date:      Mon Jul 22 17:26:52 2002 +0000

description:
Pull up revision 1.71 (requested by lukem):
- provide  .showsize [<G> <U>]  to display set size info.
  if <G> and <U> aren't provided, use values from last  .setsize <G> <U>
  reset sizes upon display
- convert to .showsize as appropriate
- fix .el ... .ie
- fix up a bunch of set sizes
- use '-unknown-', '-unset-', and '-unknown-machine-arch-' to flag
  unknown set size info (instead of "???")
- consistently use \n[MACHINE] instead of r_MACHINE
- ensure that all MACHINE_ARCH registers are at least defined to 0
- don't bother setting register _\*M

diffstat:

 distrib/notes/common/contents |  675 +++++++++++++++++++++++------------------
 1 files changed, 379 insertions(+), 296 deletions(-)

diffs (truncated from 1153 to 300 lines):

diff -r ce7d7339f5fc -r 81007a824522 distrib/notes/common/contents
--- a/distrib/notes/common/contents     Mon Jul 22 17:19:14 2002 +0000
+++ b/distrib/notes/common/contents     Mon Jul 22 17:26:52 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.52.2.15 2002/07/20 02:29:25 lukem Exp $
+.\"    $NetBSD: contents,v 1.52.2.16 2002/07/22 17:26:52 lukem Exp $
 .\"
 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -46,7 +46,8 @@
 .      It Pa INSTALL.more
 Installation notes in various file formats, including this file.
 The
-.Pa \&.more No file contains underlined text using the
+.Pa \&.more
+file contains underlined text using the
 .Xr more 1
 conventions for indicating italic and bold display.
 .      It Pa binary/
@@ -59,24 +60,24 @@
 .Nx
 kernel containing code for everything supported in this release.
 .\}
-.if r_hpcmips \{\
+.if \n[hpcmips] \{\
 This kernel runs on Vr41xx and TX3922 CPU only.
 .\}
 .
-.if r_acorn26 \{\
+.if \n[acorn26] \{\
 .                      It Pa netbsd.FOURMEG.gz
 A somewhat smaller kernel, intended to be usable on systems with
 four megabytes of RAM.
 .\}
 .
-.if r_amiga \{\
+.if \n[amiga] \{\
 .                      It Pa netbsd.INSTALL.gz
 A somewhat smaller kernel, which you can use to boot the system
 using loadbsd for installation on memory-tight systems.
 This is the same kernel as present on the miniroot.
 .\}
 .
-.if r_atari \{\
+.if \n[atari] \{\
 .                      It Pa netbsd-ATARITT.gz
 A kernel specifically tuned for the Atari TT030.
 .                      It Pa netbsd-BOOT.gz
@@ -97,12 +98,12 @@
 A kernel specifically tuned for the MILAN using IDE in PCI mode.
 .\}
 .
-.if r_hpcmips \{\
+.if \n[hpcmips] \{\
 .                      It Pa netbsd-TX3912.gz
 A kernel for TX3912 machines.
 .\}
 .
-.if r_i386 \{\
+.if \n[i386] \{\
 .                      It Pa netbsd.GENERIC_LAPTOP.gz
 A version of
 .Li GENERIC
@@ -136,7 +137,7 @@
 .Li INSTALL
 that has MCA stuff enabled to allow installing on IBM PS/2 machines.
 .\}
-.if r_mac68k \{\
+.if \n[mac68k] \{\
 .                      It Pa netbsd-GENERIC.gz
 A kernel containing code for everything supported in this release using
 the standard SCSI driver.
@@ -144,7 +145,7 @@
 A kernel containing code for everything supported in this release using
 the SBC variant of the SCSI driver.
 .\}
-.if r_macppc \{\
+.if \n[macppc] \{\
 .                      It Pa netbsd.GENERIC_MD.gz
 A gzipped
 .Nx
@@ -161,7 +162,7 @@
 one of these systems from a floppy disk.
 .\}
 .
-.if r_mvme68k \{\
+.if \n[mvme68k] \{\
 .                      It Pa netbsd.VME147.gz
 A kernel for MVME147 boards.
 .                      It Pa netbsd.VME162.gz
@@ -174,7 +175,7 @@
 A kernel for MVME177 boards.
 .\}
 .
-.if r_sgimips \{\
+.if \n[sgimips] \{\
 .                      It Pa netbsd-GENERIC_INDY.gz
 A kernel suitable for booting on Indy, Indigo 2 and similar machines.
 .                      It Pa netbsd.ecoff-GENERIC_INDY.gz
@@ -182,7 +183,7 @@
 Indy machines with PROMs that do not understand the ELF binary format.
 .\}
 .
-.if r_walnut \{\
+.if \n[walnut] \{\
 .                      It Pa netbsd-WALNUT.gz
 A gzipped
 .Nx
@@ -216,21 +217,24 @@
 \*M boot and installation floppies; see below.
 .\}
 .
-.if r_alpha \{\
+.if \n[alpha] \{\
 .              It Pa diskimage/
 .              It Pa tapeimage/
-.No \&an image file Pa cdhdtape
+.\&an image file
+.Pa cdhdtape
 is included for the case where the installer is written to
 a CD, hard drive, or tape.
 This image file is the same for the CD, HD, and tape cases, but a separate
 .Pa tapeimage/
 directory exists to hold a copy of the
-.Pa README No file and to meet the
+.Pa README
+file and to meet the
 .Nx
 .Xr release 7
 standard.
 .              It Pa instkernel/
-.No contains a Pa netbsd.gz
+contains a
+.Pa netbsd.gz
 installation kernel; this is the same installer kernel as in all the
 other install
 images, but without the various boot program and file system wrappers.
@@ -240,7 +244,12 @@
 this image.
 .\}
 .
-.if r_mac68k \{\
+.if \n[cats] \{\
+.              It Pa kernel/
+\*M installation kernels.
+.\}
+.
+.if \n[mac68k] \{\
 .              It Pa instkernel/
 \*M boot and installation kernels; see installation section (Sysinst
 Method), below.
@@ -253,7 +262,7 @@
 .if !\n[cats]:\n[mvme68k]:\n[macppc]:\n[sgimips]:\n[walnut] \{\
 .              It Pa misc/
 .
-.if r_alpha \{\
+.if \n[alpha] \{\
 contains
 .Pa GENERIC.fs ,
 a
@@ -261,7 +270,7 @@
 kernel in a bootable file system image.
 This is used in some unusual installations as described in the next section.
 .\}
-.ie r_sparc \{\
+.ie \n[sparc] \{\
 Statically-linked versions of
 .Ic gzip
 (GNU gzip) and
@@ -270,14 +279,14 @@
 .\}
 .el \{\
 Miscellaneous \*M installation utilities; see
-.if r_mac68k \{\
+.if \n[mac68k] \{\
 the Traditional method
 .\}
 installation section, below.
-\}
+.\}
 .\}
 .
-.if r_macppc \{\
+.if \n[macppc] \{\
 .              It Pa floppy/boot.fs
 \*M boot and installation floppy image.
 Only usable on models that ship with a floppy drive (pre-Open Firmware 3);
@@ -286,14 +295,14 @@
 \*M bootloader; see below.
 .\}
 .
-.if r_mvme68k \{\
+.if \n[mvme68k] \{\
 .              It Pa netboot/
 Two programs needed to boot \*M kernels over the network; see below.
 .              It Pa tapeimage/
 Tape boot programs, and a RAMDISK kernel; see below.
 .\}
 .
-.if r_sgimips \{\
+.if \n[sgimips] \{\
 .              It Pa netboot/
 NFS-root images
 .\}
@@ -303,14 +312,14 @@
 Server boot-file image for diskless machines.
 .\}
 .
-.if r_sun2 \{\
+.if \n[sun2] \{\
 .              It Pa netboot/
 Two programs needed to boot \*M kernels over the network.
 .              It Pa tapeimage/
 Tape boot program, and two shell scripts used to prepare tapes.
 .\}
 .
-.if r_sun3 \{\
+.if \n[sun3] \{\
 .              It Pa netboot/
 Two programs needed to boot \*M kernels over the network.
 .              It Pa tapeimage/
@@ -322,7 +331,7 @@
 .tag)
 .
 .
-.if r_alpha \{\
+.if \n[alpha] \{\
 .Ss2 Bootable installation/upgrade floppies
 .Pp
 There are three bootable images in the
@@ -359,7 +368,7 @@
 .\}
 .
 .
-.if r_amiga \{\
+.if \n[amiga] \{\
 .Ss2 Miniroot file system
 The Amiga now uses a single miniroot file system for both an initial
 installation and for an upgrade.
@@ -413,7 +422,9 @@
 .It Sy base
 The
 .Nx \*V
-.No \*M Sy base No binary distribution.
+\*M
+.Sy base
+binary distribution.
 You
 .Em must
 install this distribution set.
@@ -423,46 +434,46 @@
 system to run and be minimally functional.
 It includes shared library support, and excludes
 everything described below.
-.ie r_acorn26 .setsize 21 50
-.el .ie r_acorn32 .setsize 21 50
-.el .ie r_algor .setsize 22 71
-.el .ie r_alpha .setsize 25 66
-.el .ie r_amiga .setsize 17 41
-.el .ie r_arc .setsize 22 71
-.el .ie r_atari .setsize 17 41
-.el .ie r_cats .setsize 21 50
-.el .ie r_cobalt .setsize 22 71
-.el .ie r_dreamcast .setsize 66 135
-.el .ie r_evbarm .setsize 21 50
-.el .ie r_evbmips .setsize 22 71
-.el .ie r_hp300 .setsize 17 41
-.el .ie r_hpcarm .setsize 21 50
-.el .ie r_hpcmips .setsize 22 71
-.el .ie r_hpcsh .setsize 66 135
-.el .ie r_i386 .setsize 19 45
-.el .ie r_luna68k .setsize 17 41
-.el .ie r_mac68k .setsize 17 41
-.el .ie r_macppc .setsize 20 53
-.el .ie r_mipsco .setsize 22 71
-.el .ie r_mvme68k .setsize 17 41
-.el .ie r_netwinder .setsize 21 50
-.el .ie r_news68k .setsize 17 41
-.el .ie r_newsmips .setsize 22 71
-.el .ie r_next68k .setsize 17 41
-.el .ie r_pmax .setsize 22 71
-.el .ie r_prep .setsize 21 53
-.el .ie r_sandpoint .setsize 20 53
-.el .ie r_sbmips .setsize 22 71
-.el .ie r_sgimips .setsize 22 71
-.el .ie r_shark .setsize 21 50
-.el .ie r_sparc .setsize 20 50
-.el .ie r_sparc64 .setsize 21 60
-.el .ie r_sun2 .setsize 53 118
-.el .ie r_sun3 .setsize 17 41
-.el .ie r_vax .setsize 17 40
-.el .ie r_walnut .setsize 20 53
-.el .ie r_x68k .setsize 17 41
-.el .setsize ??? ???
+.if \n[acorn26] .setsize 21 50
+.if \n[acorn32] .setsize 21 50
+.if \n[algor] .setsize 22 71
+.if \n[alpha] .setsize 25 66
+.if \n[amiga] .setsize 17 41
+.if \n[arc] .setsize 22 71