[src/trunk]: src/distrib/notes/common - move a closing ".bullet)" outside of ...

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

details:   https://anonhg.NetBSD.org/src/rev/78a085a51757
branches:  trunk
changeset: 534175:78a085a51757
user:      lukem <lukem%NetBSD.org@localhost>
date:      Fri Jul 19 15:50:41 2002 +0000

description:
- move a closing ".bullet)" outside of a mac68k specific section, so
  that other platforms don't warnings about missing .El
- tweak newly added stuff to be consistent with recent cleanup i did

diffstat:

 distrib/notes/common/sysinst |  299 ++++++++++++++++++++++++------------------
 1 files changed, 171 insertions(+), 128 deletions(-)

diffs (truncated from 593 to 300 lines):

diff -r a85840f555b2 -r 78a085a51757 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Fri Jul 19 15:47:10 2002 +0000
+++ b/distrib/notes/common/sysinst      Fri Jul 19 15:50:41 2002 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.49 2002/07/19 07:17:48 scottr Exp $
+.\"    $NetBSD: sysinst,v 1.50 2002/07/19 15:50:41 lukem Exp $
 .\"
 .\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -117,7 +117,8 @@
 The
 .Tn PCMCIA
 code might allocate your soundblaster's
-.Tn IRQ No and I/O ports to
+.Tn IRQ
+and I/O ports to
 .Tn PCMCIA
 devices, causing them not to work, or to lock up the system.
 This is especially bad if one of the devices in question is your ethernet card.
@@ -263,22 +264,25 @@
 .To 2 "Possible hardware-specific issues"
 .Em Possible hardware-specific issues
 .(bullet
-.It
 .Em SCSI driver problems
 .Pp
 The SCSI driver used in the kernel on many older Macintosh systems is, by
-default, the ncrscsi driver. It contains a recognized but as yet unfixed
-bug that affects some disk drive/controller combinations,
-usually Quantum disks. Under heavy load these systems may hang or corrupt
+default, the ncrscsi driver.
+It contains a recognized but as yet unfixed bug that affects some
+disk drive/controller combinations, usually Quantum disks.
+Under heavy load these systems may hang or corrupt
 the file system; or, you may experience frequent
-.Pa Segmentation fault No and
-.Pa Illegal instruction
-errors that may or may not be consistently repeatable. This latter condition
-is particularly prevalent on systems with minimal RAM installed.
+.Em Segmentation fault
+and
+.Em Illegal instruction
+errors that may or may not be consistently repeatable.
+This latter condition is particularly prevalent on systems with
+minimal RAM installed.
 .Pp
 If either of these problems occur on your system you are advised to use the
-SBC variants of the Kernel and Installation Kernel. However, be aware that
-this issue does not affect e.g. Centris or Quadra systems.
+SBC variants of the Kernel and Installation Kernel.
+However, be aware that this issue does not affect
+e.g. Centris or Quadra systems.
 .Pp
 .It 
 .Em The 68LC040 processor
@@ -288,8 +292,8 @@
 variant of the 68040 that does not contain the floating point unit (FPU).
 The kernel is thus forced to emulate the missing operations in software.
 Unfortunately the 68LC040 processor has a design problem that causes
-the emulation to fail intermittently. We hope to provide a solution
-for this issue in a future
+the emulation to fail intermittently.
+We hope to provide a solution for this issue in a future
 .Nx
 release.
 .Pp
@@ -318,7 +322,8 @@
 at any time, but if you do, you'll have to begin the installation
 process again from scratch by running the
 .Pa /sysinst
-program from the command prompt. It is not necessary to reboot.
+program from the command prompt.
+It is not necessary to reboot.
 .It
 .To 2 "Quick install"
 .Em Quick install
@@ -354,9 +359,9 @@
 .\} \" r_i386
 .if r_mac68k \{\
 .It
-A Macintosh with a 68020 and MMU, 68030 or 68RC040 processor. An FPU is
-not required but will be used if present (but see the note above regarding
-the 68LC040).
+A Macintosh with a 68020 and MMU, 68030 or 68RC040 processor.
+An FPU is not required but will be used if present
+(but see the note above regarding the 68LC040).
 .\}
 .It
 A CD-ROM drive
@@ -451,20 +456,22 @@
 .Nx*M
 components.
 .It
-Copy the Booter application into the newly created Folder. Expand the
-file if necessary to create the Mac OS executable.
+Copy the Booter application into the newly created Folder.
+Expand the file if necessary to create the Mac OS executable.
 .It
-Copy the Installation Kernels into the newly created Folder. It is not
-necessary to
+Copy the Installation Kernels into the newly created Folder.
+It is not necessary to
 .Ic gunzip
 compressed kernel files.
 .It
 Single-click on the Booter application icon then select the "Get Info"
-from the File Menu list.  Increase the memory allocation for the Booter
-to as much as possible for your system.  Having a large number of fonts,
-extensions or sounds installed on your system can cause memory exhaustion
-problems for the Booter if you don't do this.  Also, the extra memory
-is needed by the Booter to expand compressed kernels while booting.
+from the File Menu list.
+Increase the memory allocation for the Booter to as much as possible
+for your system.
+Having a large number of fonts, extensions or sounds installed on your system
+can cause memory exhaustion problems for the Booter if you don't do this.
+Also, the extra memory is needed by the Booter to expand compressed
+kernels while booting.
 .bullet)
 .\}
 .It
@@ -486,23 +493,28 @@
 .Ic Change Monitor Depth
 and make sure B\*&W is highlighted.
 Close the window using the
-.Ic Close No button.
+.Ic Close
+button.
 .It
 From the
 .Ic Options
 pull-down menu select
 .Ic Boot Options .
 This will bring
-up an option panel.  Set the
+up an option panel.
+Set the
 .Ic Auto-set GMT Bias
 checkbox in the lower left and then select the
 .Ic Boot from Mac OS
-option at the top of the window. The
+option at the top of the window.
+The
 .Ic Set
-button on the right will become active. Use it to locate and
-select the Installation Kernel file appropiate for your hardware. This
-will be either
-.Pa netbsd-GENERIC.gz No or
+button on the right will become active.
+Use it to locate and
+select the Installation Kernel file appropiate for your hardware.
+This will be either
+.Pa netbsd-GENERIC.gz
+or
 .Pa netbsd-GENERICSBC.gz .
 Close the window using the
 .Ic Close
@@ -514,7 +526,8 @@
 .Ic Boot Now ,
 or use the Apple-B (Command-B) key combination to start the
 .Nx
-boot process.  Do not move the mouse while the boot operation is in
+boot process.
+Do not move the mouse while the boot operation is in
 progress as this may leave the keyboard locked to
 .Nx .
 .Pp
@@ -676,29 +689,34 @@
 or other software-based memory enhancement products).
 .It
 Place the system in B\*&W Mode (1-bit color or grayscale) as shown in the
-Monitors Control Panel or in the Monitors options dialog of the Booter. You may
-choose to have the Booter do this for you automatically by selecting
+Monitors Control Panel or in the Monitors options dialog of the Booter.
+You may choose to have the Booter do this for you automatically by selecting
 the appropiate check box and radio button in the
-.Ic Monitors No dialog on the
-.Ic Options No menu .
+.Ic Monitors
+dialog on the
+.Ic Options
+menu.
 .bullet)
 .Pp
 It is probably best to boot your machine with all extensions turned off [1].
 You can do this by booting into Mac OS with the
-.Tn SHIFT No key held down.  You may
-have to restart your Macintosh for changes to take effect before
+.Key SHIFT
+key held down.
+You may have to restart your Macintosh for changes to take effect before
 proceeding.
 .(tag [1]
 .It [1]
 If your version of the Memory control panel does not have a 32-bit
 addressing mode radio button, this means that your system is already
-32-bit clean and is running in 32-bit addressing mode by default.  If the
-Booter complains that your are not in 32-bit mode, it may be necessary
+32-bit clean and is running in 32-bit addressing mode by default.
+If the Booter complains that your are not in 32-bit mode, it may be necessary
 for you to press the "Use Defaults" button in the Memory control panel to
-restore 32-bit addressing.  You should probably reboot after doing so.
+restore 32-bit addressing.
+You should probably reboot after doing so.
 If you have an older II-class system (including the II, IIx, IIcx,
 and SE/30), it is necessary to install Connectix's MODE32 to work around
-ROM issues which prevent you from enabling 32-bit addressing. Please see the
+ROM issues which prevent you from enabling 32-bit addressing.
+Please see the
 .Nx*M
 FAQ at
 .Lk http://www.netbsd.org/Ports/mac68k/faq/
@@ -712,25 +730,30 @@
 .Ic Booting
 from the
 .Ic Options
-menu. Select the Kernel Location to be from Mac OS with the filename
+menu.
+Select the Kernel Location to be from Mac OS with the filename
 corresponding to the name of the Installation Kernel you are using.
 Typically this will be netbsd-INSTALL.gz.
 .Pp
 If you haven't already put your Macintosh into B\*&W mode, select the
-.Ic Monitor Options No from the
+.Ic Monitor Options
+from the
 .Ic Options
 menu and check the box for B\*&W mode.
 .Pp
 Try booting
 .Nx
 by selecting
-.Ic Boot Now No from the
-.Ic Options No menu.
+.Ic Boot Now
+from the
+.Ic Options
+menu.
 .Pp
 If the system does not come up, send mail to
 .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
+the problem as you can.
+As an alternative, try using the Traditional
 method of installation described in the next section.
 .\}
 .ie \n[acorn26]:\n[cats]:\n[macppc]:\n[pmax]:\n[sgimips]:\n[sparc]:\n[walnut] \{\
@@ -893,15 +916,16 @@
 .Nx .
 It does not support resizing existing
 .Tn Mac OS
-HFS disk partitions.  If
-there is insufficient Free space on the disk to support an installation of
+HFS disk partitions.
+If there is insufficient Free space on the disk to support an installation of
 .Nx
 you will need to backup, repartition and restore your existing
 .Tn Mac OS
-partitions before proceeding.  You may choose to use a Traditional method
-of creating disk partitions for
+partitions before proceeding.
+You may choose to use a Traditional method of creating disk partitions for
 .Nx 
-if you wish.  They can still be used by
+if you wish.
+They can still be used by
 .Ic sysinst
 for a
 .Nx
@@ -919,7 +943,7 @@
 onto a dedicated drive.
 .Pp
 Go to the
-.Me "Utility Menu" No Ns ,
+.Me "Utility Menu" ,
 and select the
 .Me "Run /bin/sh"
 option which will give you a shell prompt.
@@ -946,15 +970,15 @@
 section, your
 .Em "A/UX Root"
 typically is the first partition
-.No ( Ns Em a No Ns )
+.Pq Em a
 and your
 .Em "A/UX Swap"
 typically is the second partition
-.No ( Ns Em b No Ns ).
+.Pq Em b .
 You may also find that your
 .Em "A/UX User"
 partition is the seventh partition
-.No ( Ns Em g No Ns ).
+.Pq Em g .
 For example:
 .(disp
 .Dl # Ic "disklabel wd0"
@@ -976,11 +1000,13 @@
 will be using.