[src/trunk]: src/distrib/notes/common Changes:

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

details:   https://anonhg.NetBSD.org/src/rev/b238e815804e
branches:  trunk
changeset: 569491:b238e815804e
user:      hubertf <hubertf%NetBSD.org@localhost>
date:      Sun Aug 22 01:54:29 2004 +0000

description:
Changes:
 * update copyright year
 * update list of ports     XXX portmasters please check!
 * fix a few paths
 * note that you can also get into OFW via a BREAK if on cereal console
 * pkgsrc is at something like 5000 pkgs
 * remove a few numbers that would need maintenance otherwise
   (and that aren't easy to determine - ports (not) released in binary)
 * Yank section on "upgrade path to netbsd 1.6", same for 1.5
 * There are no more README.export-control files (it seems?)
 * Update compressed+unpacked src set sizes (estimate xsrc & pkgsrc)
 * mention updating via CVS besides SUP
 * Update list of obsolete /etc/rc.d files, new and removed users & groups
 * Update list of sites that host/run our hardware (-redback, +isc, +ssh.fi)
 * Create list of portmeisters from scratch, with list-portmeisters.pl

Todo:
 * what's the exact number of ports, archs and cpus supported?
 * the "new in 2.0" list needs ... um, creation. Badly!
 * "The Future of NetBSD" may need updating
 * where is xsrc.tar.gz?
 * Fix formatting bug in automatically created portmeister-list
   in INSTALL.txt at "UCHIYAMA Yasushi" (XXX needs a *roff guru?)
 * the "releng" crew disagrees between this file and
   http://www.netbsd.org/People/groups/#releng

diffstat:

 distrib/notes/common/main |  484 +++++++++++----------------------------------
 1 files changed, 118 insertions(+), 366 deletions(-)

diffs (truncated from 711 to 300 lines):

diff -r 59a966d67250 -r b238e815804e distrib/notes/common/main
--- a/distrib/notes/common/main Sun Aug 22 01:36:20 2004 +0000
+++ b/distrib/notes/common/main Sun Aug 22 01:54:29 2004 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: main,v 1.262 2004/07/30 06:19:14 ian Exp $
+.\"    $NetBSD: main,v 1.263 2004/08/22 01:54:29 hubertf Exp $
 .\"
-.\" Copyright (c) 1999-2002 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -44,16 +44,16 @@
 .
 .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 evbppc evbsh3
-.as MACHINE_LIST " hp300 hp700 hpcarm hpcmips hpcsh i386 luna68k mac68k macppc
+.ds MACHINE_LIST acorn26 acorn32 algor alpha amd64 amiga amigappc arc atari bebox
+.as MACHINE_LIST " cats cesfic cobalt dreamcast evbarm evbmips evbppc evbsh3 evbsh5 
+.as MACHINE_LIST " hp300 hp700 hpcarm hpcmips hpcsh hppa i386 ibmnws luna68k mac68k macppc
 .as MACHINE_LIST " mipsco mmeye mvme68k mvmeppc netwinder news68k newsmips
-.as MACHINE_LIST " next68k ofppc pc532 playstation2 pmax pmppc prep sandpoint
+.as MACHINE_LIST " next68k ofppc openblocks pc532 pdp10 playstation2 pmax pmppc prep sandpoint
 .as MACHINE_LIST " sbmips sgimips shark sparc sparc64 sun2 sun3 vax 
-.as MACHINE_LIST " x68k x86_64 xen .
+.as MACHINE_LIST " x68k xen .
 .so \*[.CURDIR]/../common/macros
 .
-.Dd September 7, 2002
+.Dd August 22, 2004
 .Dt INSTALL 8
 .Os NetBSD
 .Sh NAME
@@ -116,7 +116,7 @@
 Fetch the
 .if \n[i386] \{\
 appropriate pair of boot floppy images from the
-.Pa installation/floppy/
+.Pa i386/installation/floppy/
 directory.
 Most people will need the
 .Pa boot1.fs
@@ -134,15 +134,15 @@
 are using and how you plan to boot your machine.
 For systems with built-in floppy drives (Open Firmware 1 or 2), 
 fetch the pair of boot floppy images
-.Pa installation/floppy/boot1.fs
+.Pa macppc/installation/floppy/boot1.fs
 and
-.Pa installation/floppy/boot2.fs ,
+.Pa macppc/installation/floppy/boot2.fs ,
 which include the bootloader and installation kernel.
 For systems without floppy drives (most are Open Firmware 3), fetch the
 bootloader
-.Pa installation/ofwboot.xcf
+.Pa macppc/installation/ofwboot.xcf
 and the installation kernel
-.Pa binary/kernel/netbsd-GENERIC_MD.gz .
+.Pa macppc/binary/kernel/netbsd-GENERIC_MD.gz .
 If you have a CD-R, you can fetch the CD image,
 .Pa macppccd.iso .
 .\}
@@ -150,14 +150,14 @@
 CD image,
 .Pa sparccd.iso
 or the floppy disk images,
-.Pa install/floppy/disk1.gz No and Pa install/floppy/disk2 .
+.Pa sparc/install/floppy/disk1.gz No and Pa sparc/install/floppy/disk2 .
 You need either the pair of floppies or the CD to boot your system.
 .\}
 .if \n[sparc64] \{\
 CD image,
 .Pa sparc64cd.iso
 or the installation kernel and bootloader,
-.Pa binary/kernel/netbsd-INSTALL.gz No and Pa installation/misc/ofwboot
+.Pa sparc64/binary/kernel/netbsd-INSTALL.gz No and Pa sparc64/installation/misc/ofwboot
 which can be booted from a
 .Tn Solaris
 or
@@ -170,7 +170,7 @@
 .\}
 .It
 The actual binary distribution is in the
-.Pa binary/sets/
+.Pa \*M/binary/sets/
 directory.
 When you boot the install
 .if \n[i386] floppies,
@@ -210,7 +210,7 @@
 Windows32 program (inside
 .Pa rawrite32.zip )
 in the
-.Pa utilities/
+.Pa i386/installation/misc/
 directory may be of help.
 .\}
 .if \n[macppc] \{
@@ -334,7 +334,7 @@
 After your system first powers on, and displays some initial information,
 press the
 .Key STOP-A
-keys.
+keys, or send a BREAK of you're on a serial console.
 At the
 .Dq Ic "ok"
 prompt, type the command to boot your system into
@@ -375,7 +375,7 @@
 .Nx
 distribution, you will want to explore the
 .Ic pkgsrc
-system with its more than 3000 program packages.
+system with its more than 5000 program packages.
 .El
 .\}
 .Ss "What is NetBSD?"
@@ -389,15 +389,15 @@
 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 fifty three different system architectures (ports),
+runs on fifty four different system architectures (ports),
 featuring seventeen machine architectures
-across eleven distinct CPU families,
+across fifteen distinct CPU families,
 and is being ported to more.
 The
 .Nx \*V
-release contains complete binary releases for thirty eight different
+release contains complete binary releases for many different
 system architectures.
-(The fifteen remaining are not fully supported at this time
+(A few ports are not fully supported at this time 
 and are thus not part of the binary distribution.
 For information on them, please see the
 .Nx
@@ -421,57 +421,12 @@
 possible, it's likely that
 .Nx
 wouldn't exist.
-.Ss Upgrade path to NetBSD 1.6
-If you are not installing your system ``from scratch'' but instead
-are going to upgrade an existing system already running
-.Nx
-you need to know which versions you can upgrade with
-.Nx 1.6 .
-.Pp
-.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
-in our CVS repository (also known as ``NetBSD-current'') from
-.Em after
-the point where the release cycle for 1.6 was started are designated
-by version identifiers such as 1.6A, 1.6B, etc.
-These identifiers do not designate releases, but indicate major changes
-in internal kernel APIs.
-Note that the kernel from
-.Nx
-1.6 can
-.Em not
-be used to upgrade a system running one of those intermediate development
-versions.
-Trying to use the
-.Nx
-1.6 kernel on such a system
-.Em will
-probably result in problems.
-.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 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.6 and its patch releases selected
-fixes and enhancements have been imported from the main development
-trunk.
-.ig
-For example, there may be features in 1.6.1 which were not in 1.6B,
-and vice versa.
 ..
 .if \n[FOR_RELEASE] \{\
-.Ss Changes Between The NetBSD 1.5 and 1.6 Releases
+.Ss Changes Between The NetBSD 1.6 and 2.0 Releases
 .Pp
 The
-.Nx 1.6
+.Nx 2.0
 release
 provides numerous significant functional enhancements, including
 support for many new devices, integration of hundreds of bug fixes,
@@ -484,6 +439,8 @@
 .Nx \*V
 release.
 Some highlights include:
+XXX the following is still news in 1.6
+XXX needs updating!
 .
 .Ss2 Kernel
 .
@@ -984,19 +941,6 @@
 directory per architecture, for each of the architectures for which
 .Nx \*V
 has a binary distribution.
-There are also
-.Pa README.export-control
-files sprinkled liberally throughout the
-distribution tree, which point out that there are some portions of the
-distribution that may be subject to
-export regulations of the United States, e.g.
-code under
-.Pa src/crypto
-and
-.Pa src/sys/crypto .
-It is your responsibility
-to determine whether or not it is legal for you to export these portions
-and to act accordingly.
 .Pp
 The source distribution sets can be found in subdirectories of the
 .Pa source
@@ -1009,19 +953,19 @@
 .Dq gnu
 sources, including the source for the compiler, assembler, groff,
 and the other GNU utilities in the binary distribution sets.
-.showsize 55 247
+.showsize 79 367
 .It Sy pkgsrc
 This set contains the
 .Dq pkgsrc
 sources, which contain the infrastructure to build third-party packages.
-.showsize 12 94
+.showsize 24 200
 .It Sy sharesrc
 This set contains the
 .Dq share
 sources, which include the sources for the man pages not associated
 with any particular program; the sources for the typesettable document
 set; the dictionaries; and more.
-.showsize 4 16
+.showsize 5 20
 .It Sy src
 This set contains all of the base
 .Nx \*V
@@ -1030,7 +974,7 @@
 .Sy sharesrc ,
 or
 .Sy syssrc .
-.showsize 27 136
+.showsize 37 176
 .It Sy syssrc
 This set contains the sources to the
 .Nx \*V
@@ -1038,10 +982,10 @@
 .Xr config 8 ;
 and
 .Xr dbsym 8 .
-.showsize 22 114
+.showsize 26 140
 .It Sy xsrc
 This set contains the sources to the X Window System.
-.showsize 78 394
+.showsize 84 450
 .tag)
 .Pp
 All the above source sets are located in the
@@ -1099,8 +1043,6 @@
 .Pp
 .Pa \&.../NetBSD-current/tar_files/
 .(item -compact -offset indent
-.Pa doc.tar.gz
-.It
 .Pa pkgsrc.tar.gz
 .It
 .Pa src/*.tar.gz
@@ -1108,9 +1050,10 @@
 .Pa xsrc/*.tar.gz
 .item)
 .Pp
-Other directories provide unpacked source trees for distribution via
-the source update protocol, for more information see:
-.Lk http://www.NetBSD.org/Sites/net.html#sup
+Other directories provide unpacked source trees e.g. for distribution via
+the the software update protocol (SUP) or the
+concurrent version system (CVS). For more information see:
+.Lk http://www.NetBSD.org/mirrors/
 .\}
 .
 .
@@ -1169,7 +1112,7 @@
 following problems and compatibility issues in mind when upgrading to
 .Nx \*V .
 .
-.Ss2 Issues affecting an upgrade from NetBSD 1.5
+.Ss2 Issues affecting an upgrade from NetBSD 1.6