[src/trunk]: src/distrib/notes/common - more "1.5*" -> "1.6" reference updates

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

details:   https://anonhg.NetBSD.org/src/rev/3fef48f85e3d
branches:  trunk
changeset: 533388:3fef48f85e3d
user:      lukem <lukem%NetBSD.org@localhost>
date:      Sat Jun 29 08:36:06 2002 +0000

description:
- more "1.5*" -> "1.6" reference updates
- remove 1.5.x changes;  still need to update changes between 1.5 - 1.6
  (i'm working on it)
- copyright crank
- whitespace cleanup
- formatting cleanup (start sentences on new lines)

diffstat:

 distrib/notes/common/main |  406 ++++++++++++++++-----------------------------
 1 files changed, 143 insertions(+), 263 deletions(-)

diffs (truncated from 715 to 300 lines):

diff -r 4e29588ccb86 -r 3fef48f85e3d distrib/notes/common/main
--- a/distrib/notes/common/main Sat Jun 29 08:32:30 2002 +0000
+++ b/distrib/notes/common/main Sat Jun 29 08:36:06 2002 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: main,v 1.189 2002/06/25 17:38:31 jschauma Exp $
+.\"    $NetBSD: main,v 1.190 2002/06/29 08:36:06 lukem Exp $
 .\"
-.\" Copyright (c) 1999-2001 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -45,7 +45,7 @@
 .nr FOR_RELEASE 1
 .nr DOC_XR 1
 .ds MACHINE_LIST acorn26 acorn32 algor alpha amiga amigappc arc atari bebox
-.as MACHINE_LIST " cats cesfic cobalt dreamcast evbarm evbmips evbsh3 hp300 
+.as MACHINE_LIST " cats cesfic cobalt dreamcast evbarm evbmips evbsh3 hp300
 .as MACHINE_LIST " hpcarm hpcmips hpcsh i386 luna68k mac68k macppc mipsco
 .as MACHINE_LIST " mmeye mvme68k mvmeppc netwinder news68k newsmips next68k
 .as MACHINE_LIST " ofppc pc532 playstation2 pmax pmppc prep sandpoint sbmips
@@ -53,7 +53,7 @@
 .
 .so \*[.CURDIR]/../common/macros
 .
-.Dd May 21, 2001
+.Dd June 28, 2002
 .Dt INSTALL 8
 .Os NetBSD
 .Sh NAME
@@ -71,7 +71,8 @@
 .Nx \*V
 on the
 .Em \*M
-platform. It is available in four different formats titled
+platform.
+It is available in four different formats titled
 .Pa INSTALL. Ns Ar ext ,
 where
 .Ar \&.ext
@@ -90,7 +91,8 @@
 .Xr more 1
 and
 .Xr less 1
-pager utility programs. This is the format in which the on-line
+pager utility programs.
+This is the format in which the on-line
 .Em man
 pages are generally presented.
 .It Pa \&.txt
@@ -115,7 +117,8 @@
 .if r_i386 \{\
 appropriate pair of boot floppy images from the
 .Pa installation/floppy/
-directory.  Most people will need the
+directory.
+Most people will need the
 .Pa boot1.fs
 and
 .Pa boot2.fs
@@ -126,18 +129,19 @@
 if installing on a laptop.
 .\}
 .if r_macppc \{\
-files necessary to boot your system.  The files depend on what model you
-are using and how you plan to boot your machine.  For systems with 
-built-in floppy drives, fetch the bootloader
-.Pa installation/ofwboot.xcf 
+files necessary to boot your system.
+The files depend on what model you
+are using and how you plan to boot your machine.
+For systems with built-in floppy drives, fetch the bootloader
+.Pa installation/ofwboot.xcf
 and the installation kernel
 .Pa binary/kernel/netbsd.INSTALL.gz .
 For systems without floppy drives, fetch the bootloader
-.Pa installation/ofwboot.xcf 
+.Pa installation/ofwboot.xcf
 and the installation kernel
 .Pa binary/kernel/netbsd.GENERIC_MD.gz .
 Alternatively, you can fetch the CD image,
-.Pa macppc_bootable.iso 
+.Pa macppc_bootable.iso
 or the boot floppy image
 .Pa installation/floppy/boot.fs
 which include the bootloader and installation kernel.
@@ -151,8 +155,8 @@
 .\}
 .if \n[macppc]:\n[sparc] \{\
 Alternatively, you may netboot the installation kernel, which requires
-several local netboot services.  The details are not covered here, as
-setting up a netboot server is hardly 
+several local netboot services.
+The details are not covered here, as setting up a netboot server is hardly
 .Dq quick .
 .\}
 .It
@@ -205,16 +209,17 @@
 .Pa ofwboot.xcf No and Pa netbsd.INSTALL.gz
 to an MS-DOS formatted floppy disk and rename
 .Pa netbsd.INSTALL.gz No to Pa netbsd.gz .
-Otherwise, drag 
+Otherwise, drag
 .Pa ofwboot.xcf No and Pa netbsd.GENERIC_MD.gz
-to your hard drive icon (the top level of the drive, not the desktop).  If 
-you are making a CD, burn it now.
+to your hard drive icon (the top level of the drive, not the desktop).
+If you are making a CD, burn it now.
 .\}
 .if \n[sparc] \{
 .It
-Make sure your sparc's CD-ROM drive is bootable.  Burn the CD.  Otherwise,
-write the floppy images directly to a pair of floppies (after
-uncompressing disk1.gz).
+Make sure your sparc's CD-ROM drive is bootable.
+Burn the CD.
+Otherwise, write the floppy images directly to a pair of floppies
+(after uncompressing disk1.gz).
 .\}
 .Pp
 The disk(s) you just prepared will be used to boot the installation
@@ -233,11 +238,12 @@
 .Tn MacOS
 unless you partition your disk using a
 .Tn MacOS
-partitioning utility.  Open Firmware versions prior to 3 cannot boot into
+partitioning utility.
+Open Firmware versions prior to 3 cannot boot into
 .Nx
-on a drive partitioned this way -- you must use the entire disk,
-partitioned with the installation tools.  Open Firmware version 3 cannot
-boot into
+on a drive partitioned this way \(em you must use the entire disk,
+partitioned with the installation tools.
+Open Firmware version 3 cannot boot into
 .Nx
 on a drive partitioned with the installation tools, you must use a
 .Tn MacOS
@@ -247,17 +253,18 @@
 .Dq Me "Install NetBSD to hard disk"
 or
 .Dq Me "Upgrade NetBSD on a hard disk"
-options will render your drive unbootable).  If you are unsure, you may
-want to read the section below on
+options will render your drive unbootable).
+If you are unsure, you may want to read the section below on
 .Sx Partitioning your hard drive for NetBSD
 .It
 For systems with Open Firmware versions prior to 3, you may need to use
 Apple's System Disk utility to enter Open Firmware and use your screen and
-keyboard.  To enter Open Firmware, hold down the
+keyboard.
+To enter Open Firmware, hold down the
 .Key COMMAND-OPTION-O-F
-keys after the boot chime starts, but before it ends.  Entering Open
-Firmware versions prior to 3 is usually the most frustrating part of
-installation -- you may want to read the section below on
+keys after the boot chime starts, but before it ends.
+Entering Open Firmware versions prior to 3 is usually the most frustrating
+part of installation \(em you may want to read the section below on
 .Sx Older Open Firmware System Preparation
 .Pp
 You should have the Open Firmware
@@ -267,8 +274,8 @@
 .\}
 .if r_macppc \{\
 .It
-At the Open Firmware prompt, type the command to boot.  To boot from a
-floppy, the command is
+At the Open Firmware prompt, type the command to boot.
+To boot from a floppy, the command is
 .Dq Ic "boot fd:,\eofwboot.xcf netbsd.gz" .
 For the install kernel and bootloader on your hard drive (Open Firmware
 3), the command is
@@ -281,12 +288,14 @@
 (for earlier Open Firmware versions).
 You will need to use the correct case for
 .Ic OFWBOOT.XCF No and Ic NETBSD.MACPPC
-depending on how your version of Open Firmware interprets the ISO 
-filesystem.  You may need to replace
+depending on how your version of Open Firmware interprets the ISO
+filesystem.
+You may need to replace
 .Ic cd
 with
 .Ic "scsi/sd@3 , scsi-int/sd@3 , scsi-ext/sd@3 , ata/atapi-disk ,"
-or some other device alias.  You should also use the Open Firmware
+or some other device alias.
+You should also use the Open Firmware
 .Ic dir
 command to confirm that the
 .Nx*M
@@ -297,10 +306,12 @@
 .It
 You will need to get to the OpenBoot PROM
 .Dq Ic "ok"
-prompt.  After your system first powers on, and displays some initial
-information, press the
+prompt.
+After your system first powers on, and displays some initial information,
+press the
 .Key STOP-A
-keys.  At the
+keys.
+At the
 .Dq Ic "ok"
 prompt, type the command to boot your system into
 .Nx .
@@ -323,7 +334,7 @@
 .Nx
 distribution, you will want to explore the
 .Ic pkgsrc
-system with its more than 2100 program packages.
+system with its more than 2700 program packages.
 .El
 .\}
 .Ss "What is NetBSD?"
@@ -337,13 +348,17 @@
 operating system derived from the University of California, Berkeley
 Networking Release 2 (Net/2), 4.4BSD-Lite, and 4.4BSD-Lite2 sources.
 .Nx
-runs on thirty-one different system architectures featuring twelve distinct
-families of CPUs, and is being ported to more. The
+runs on fifty three different system architectures (ports),
+featuring seventeen machine architectures
+across eleven distinct CPU families,
+and is being ported to more.
+The
 .Nx \*V
-release contains complete binary releases for fifteen different
-machine types. (The sixteen remaining are not fully supported at this time
-and are thus not part of the binary distribution. For information on
-them, please see the
+release contains complete binary releases for thirty eight different
+system architectures.
+(The fifteen remaining are not fully supported at this time
+and are thus not part of the binary distribution.
+For information on them, please see the
 .Nx
 web site at
 .Lk http://www.netbsd.org/ . )
@@ -370,13 +385,12 @@
 are going to upgrade an existing system already running
 .Nx
 you need to know which versions you can upgrade with
-.Nx
-1.6.
+.Nx 1.6 .
 .Pp
-.Nx
-1.6 is an upgrade of
-.Nx
-1.5.3 and earlier major and patch releases of
+.Nx 1.6
+is an upgrade of
+.Nx 1.5.3
+and earlier major and patch releases of
 .Nx .
 .Pp
 The intermediate development versions of code available on the main trunk
@@ -400,178 +414,34 @@
 .Pp
 Please also note that it is not possible to do a direct ``version''
 comparison between any of the intermediate development versions mentioned
-above and 1.6.1 to determine if a given feature is present or absent
-in 1.6.1.  The development of 1.6 and the subsequent ``point'' releases
-is done on a separate branch in the CVS repository. The branch was created when
-the release cycle for 1.6 was started, and during the release cycle of
-1.5 and its patch releases, selected fixes and enhancements have been
-imported from the main development trunk.
+above and 1.6 to determine if a given feature is present or absent
+in 1.6.
+The development of 1.6 and the subsequent ``point'' releases
+is done on a separate branch in the CVS repository.
+The branch was created when the release cycle for 1.6 was started,
+and during the release cycle of 1.5 and its patch releases,
+selected fixes and enhancements have been imported from the
+main development trunk.
+.ig
 So, there are features in 1.6.1 which were not in, e.g. 1.6B, and vice
 versa.
-.Ss Major Changes Between 1.5 and 1.5.1
-The complete list of changes between
-.Nx
-1.5 and 1.5.1 can be found in the file CHANGES-1.5.1 in the top directory
-of the source tree.
-The following are highlights only:
-.Bl -bullet
-.It
-A driver for the Aironet/Cisco wireless PCMCIA cards has been added;
-see
-.Xr an 4 .
-.It
-NFS client performance has been improved, typically by 40% for
-writes but possibly up to 100% in certain setups.
-.It
-The
-.Xr siop 4
-driver has improved in performance and robustness. A
-.Xr esiop 4