[src/trunk]: src/distrib/notes Several changes to our release notes, OK'd by ...

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

details:   https://anonhg.NetBSD.org/src/rev/61e97c77d7fd
branches:  trunk
changeset: 499143:61e97c77d7fd
user:      hubertf <hubertf%NetBSD.org@localhost>
date:      Mon Nov 13 01:22:39 2000 +0000

description:
Several changes to our release notes, OK'd by Luke Mewburn:

  * mention additional kernels in binary/kernel/ dir: GENERIC_LAPTOP, etc
  * note that we also include firewall software (besides X, ...)
  * don't Xref the BUGS file, as it's gone
  * update some file sizes (source .tgz files) to match BETA2
  * mention that syssrc contains the source for all architectures
  * Sysinst now allows setting root password and timezone - note that.
  * Explain how to actually install binary packages, giving some
    examples that people may want to install.
  * Mention rawrite32 near rawrite.
  * Don't show preparation of install tape on i386
  * update i386 hardware a bit. This needs to be generated automatically...
  * Many minor nits & typos.

diffstat:

 distrib/notes/common/contents    |  25 +++++++++++++++++++--
 distrib/notes/common/main        |  34 ++++++++++++++----------------
 distrib/notes/common/postinstall |  44 ++++++++++++++++++++++++++++----------
 distrib/notes/common/sysinst     |  16 +++++++++----
 distrib/notes/common/xfer        |  16 ++++++++++---
 distrib/notes/i386/hardware      |  45 ++++++++++++++++++++++++++++-----------
 distrib/notes/i386/whatis        |   3 +-
 7 files changed, 127 insertions(+), 56 deletions(-)

diffs (truncated from 491 to 300 lines):

diff -r c2fe2e557830 -r 61e97c77d7fd distrib/notes/common/contents
--- a/distrib/notes/common/contents     Mon Nov 13 00:30:48 2000 +0000
+++ b/distrib/notes/common/contents     Mon Nov 13 01:22:39 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: contents,v 1.29 2000/11/03 23:23:47 lukem Exp $
+.\"    $NetBSD: contents,v 1.30 2000/11/13 01:22:39 hubertf Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -44,14 +44,15 @@
 .      It Pa INSTALL.ps
 .      It Pa INSTALL.txt
 .      It Pa INSTALL.more
-Installation notes; this file. The
+Installation notes in various file formats, including this file.
+The
 .Pa \&.more No file contains underlined text using the
 .Xr more 1
 conventions for indicating italic and bold display.
 .      It Pa binary/
 .      (tag instkernel/ -compact
 .              It Pa kernel/
-.              (tag netbsd.INSTALL_TINY.gz -compact
+.              (tag netbsd.INSTALL_LAPTOP.gz -compact
 .                      It Pa netbsd.GENERIC.gz
 A gzipped
 .Nx
@@ -74,12 +75,30 @@
 .\}
 .
 .if r_i386 \{\
+.                      It Pa netbsd.GENERIC_LAPTOP.gz
+A version of 
+.Li GENERIC
+that has USB, PCMCIA and Cardbus enabled to allow
+installing on Laptop machine.
+.                      It Pa netbsd.GENERIC_TINY.gz
+A version of
+.Li GENERIC
+intended to run on machines with less than 8 MB.
 .                      It Pa netbsd.INSTALL.gz
 The install kernel.
 .                      It Pa netbsd.INSTALL_TINY.gz
 A version of
 .Li INSTALL
 intended to run on machines with less than 8 MB.
+.                      It Pa netbsd.INSTALL_SMALL.gz
+A version of
+.Li INSTALL
+intended to fit on a 5.25"/1.2 MB diskette.
+.                      It Pa netbsd.INSTALL_LAPTOP.gz
+A version of 
+.Li INSTALL
+that has USB, PCMCIA and Cardbus enabled to allow
+installing on Laptop machine.
 .\}
 .
 .if r_mvme68k \{\
diff -r c2fe2e557830 -r 61e97c77d7fd distrib/notes/common/main
--- a/distrib/notes/common/main Mon Nov 13 00:30:48 2000 +0000
+++ b/distrib/notes/common/main Mon Nov 13 01:22:39 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: main,v 1.90 2000/11/12 03:22:47 hubertf Exp $
+.\"    $NetBSD: main,v 1.91 2000/11/13 01:22:39 hubertf Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -124,7 +124,7 @@
 In addition to its highly portable, high performance kernel,
 .Nx
 features a complete set of user utilities, compilers for several
-languages, The X Window System,
+languages, The X Window System, firewall software
 and numerous other tools, all accompanied by full source code.
 .Pp
 .\" XXX Should we include some text here about NetBSD's license
@@ -140,8 +140,8 @@
 .Pp
 The
 .Nx \*V
-release is a substantial improvement over its predecessors.  We have
-provided numerous significant functional enhancements, including
+release 
+provides numerous significant functional enhancements, including
 support for many new devices, integration of hundreds of bug fixes,
 new and updated kernel subsystems, and many userland enhancements. The
 result of these improvements is a stable operating system fit for
@@ -217,10 +217,10 @@
 .Sq NTFS
 file system (read-only at this stage).
 .It
-Support for the
+Support for revision 1 of the
 .Tn Linux
 .Sq extfs
-(revision 1) file system.
+file system.
 .It
 Enhanced stability and usability of LFS (the
 .Bx
@@ -237,11 +237,11 @@
 Joliet extensions to the ISO9660 CD file system.
 .It
 Improved file system vnode locking mechanisms,
-thus resolving a source of some panics in the past.
+thus resolving a source of several panics in the past.
 .It
-Support for NFS (and RPC) over IPv6.
+Support for NFS and RPC over IPv6.
 .It
-The NFS locking protocol (implemented with
+NFS locking (implemented with
 .Xr rpc.lockd 8 )
 now works.
 .bullet)
@@ -439,8 +439,6 @@
 .Pp
 .Pa .../NetBSD-\*V/
 .(tag LAST_MINUTE
-.It Li BUGS
-Known bugs list (somewhat incomplete and out of date).
 .It Li CHANGES
 Changes since earlier
 .Nx
@@ -498,7 +496,7 @@
 .Dq pkgsrc
 sources, which contain the infrastructure to build third-party packages.
 .br
-.Em 7.1 MB gzipped, 61.0 MB uncompressed
+.Em 5.6 MB gzipped, 57.0 MB uncompressed
 .It Sy sharesrc
 This set contains the
 .Dq share
@@ -516,11 +514,11 @@
 or
 .Sy syssrc .
 .br
-.Em 23.8 MB gzipped, 117.4 MB uncompressed
+.Em 24.2 MB gzipped, 120.6 MB uncompressed
 .It Sy syssrc
 This set contains the sources to the
 .Nx \*V
-kernel,
+kernel for all architectures,
 .Xr config 8 ,
 and
 .Xr dbsym 8 .
@@ -529,7 +527,7 @@
 .It Sy xsrc
 This set contains the sources to the X Window System.
 .br
-.Em 35.2 MB gzipped, 175.2 MB uncompressed
+.Em 35.2 MB gzipped, 176.8 MB uncompressed
 .tag)
 .Pp
 All the above source sets are located in the
@@ -548,7 +546,7 @@
 subdirectory contains split
 versions of the source sets for those users who need to load the
 source sets from floppy or otherwise need a split distribution. The
-split sets are are named
+split sets are named
 .Pa "set_name." Ns Ar xx
 where
 .Pa set_name
@@ -846,7 +844,7 @@
 to read the documentation for
 .Xr passwd 1 .
 To view the documentation for
-.Xr passwd 5 m
+.Xr passwd 5 ,
 enter
 .Pp
 .Dl # Ic "man 5 passwd"
@@ -911,7 +909,7 @@
 .Pp
 As a favor, please avoid mailing huge documents or files to these
 mailing lists. Instead, put the material you would have sent up
-for FTP somewhere, then mail the appropriate list about it, or, if
+for FTP or WWW somewhere, then mail the appropriate list about it, or, if
 you'd rather not do that, mail the list saying you'll send the data
 to those who want it.
 .
diff -r c2fe2e557830 -r 61e97c77d7fd distrib/notes/common/postinstall
--- a/distrib/notes/common/postinstall  Mon Nov 13 00:30:48 2000 +0000
+++ b/distrib/notes/common/postinstall  Mon Nov 13 01:22:39 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: postinstall,v 1.18 2000/11/12 03:10:45 wiz Exp $
+.\"    $NetBSD: postinstall,v 1.19 2000/11/13 01:22:40 hubertf Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -39,7 +39,8 @@
 .Pa /etc/rc.conf
 .Pp
 If you or the installation software haven't done any configuration of
-.Pa /etc/rc.conf ,
+.Pa /etc/rc.conf 
+(sysinst usually will),
 the system will drop you into single user mode on first reboot with the
 message
 .Pp
@@ -50,7 +51,9 @@
 mounted read-write. When the system
 asks you to choose a shell, simply press
 .Key RETURN
-to get to a prompt. If you are asked for a terminal type, respond with
+to get to a 
+.Pa /bin/sh
+prompt. If you are asked for a terminal type, respond with
 .ie r_hp300 \{\
 .Ic hp300h
 for a local console, or whatever is appropriate for your serial console.
@@ -86,7 +89,8 @@
 so that your changes will be enabled and a multi-user boot can
 proceed.
 Default values for the various programs can be found in
-/etc/defaults/rc.conf, where some in-line documentation may be found.
+.Pa /etc/defaults/rc.conf ,
+where some in-line documentation may be found.
 More complete documentation can be found in
 .Xr rc.conf 5 .
 .Pp
@@ -127,8 +131,9 @@
 .Ar defaultroute ,
 furthermore add an
 .Ar ifconfig_int
-for your interface
-.Aq int ,
+for your
+.Aq int
+network interface, 
 .ie r_macppc \{\
 where your on-board interfaces may be one of
 .Li mc0 , bm0 , No or Li gm0
@@ -180,8 +185,8 @@
 .Pp
 After reboot, you can log in as
 .Li root
-at the login prompt. There
-is no initial password, but if you're using the machine in a
+at the login prompt. Unless you've set a password in sysinst, there
+is no initial password. If you're using the machine in a
 networked environment, you should create an account for yourself
 (see below) and protect it and the
 .Dq root
@@ -244,9 +249,24 @@
 .Lk ftp://ftp.netbsd.org/pub/NetBSD/packages/pkgsrc/README.html
 .It
 Precompiled binaries can be found at
-.Lk ftp://ftp.netbsd.org/pub/NetBSD/packages/
+.Lk ftp://ftp.netbsd.org/pub/NetBSD/packages ,
+usually in the
+.Pa \*V/\*M/All
+subdir.  You can install them with the following commands:
+.Pp
+.Dl # Ic export PKG_PATH=ftp://ftp.netbsd.org/pub/NetBSD/packages/\*V/\*M/All
+.Dl # Ic pkg_add -v tcsh
+.Dl # Ic pkg_add -v cvs
+.Dl # Ic pkg_add -v apache
+.Dl # Ic pkg_add -v perl
+.Dl # Ic ...
+.Pp
+The above commands will install the tcsh shell, the CVS source code
+management system, the Apache web server and
+the perl programming language as well as all the packages they
+depend on. 
 .It
-Package sources for compiling packages can be obtained by
+Package sources for compiling packages on your own can be obtained by
 retrieving the file
 .Lk ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz
 They are typically extracted into
@@ -267,9 +287,9 @@
 .(bullet
 Edit
 .Pa /etc/mail/aliases
-to forward root mail to the right place (run
+to forward root mail to the right place. Don't forget to run
 .Xr newaliases 1
-afterwards.)
+afterwards.
 .It
 The
 .Pa /etc/mail/sendmail.cf
diff -r c2fe2e557830 -r 61e97c77d7fd distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Mon Nov 13 00:30:48 2000 +0000
+++ b/distrib/notes/common/sysinst      Mon Nov 13 01:22:39 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: sysinst,v 1.15 2000/11/03 20:30:57 tv Exp $
+.\"    $NetBSD: sysinst,v 1.16 2000/11/13 01:22:40 hubertf Exp $
 .\"
 .\" Copyright (c) 1999, 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -144,10 +144,10 @@
 For example, 0x0a00 allows both IRQ 9 and IRQ 11. By default,
 the
 .Tn Li INSTALL
-kernel permits all IRQs other than IRQ 5, so the corresponding
+kernel permits all IRQs other than IRQs 5 and 7, so the corresponding