Subject: "nits" in the INSTALL document
To: None <netbsd-docs@netbsd.org>
From: Pavel Cahyna <pcah8322@artax.karlin.mff.cuni.cz>
List: netbsd-docs
Date: 11/21/2005 23:48:15
Hello,
I noticed the following little problems in the 3.0_RC1 INSTALL document.
(ftp://ftp.netbsd.org/pub/NetBSD-daily/netbsd-3-0-RC1/200511171553Z/i386/INSTALL.html)
- #Supported%20devices:
extra bullet at the beginning.
- #Changes%20Between%20The%20NetBSD%202.0%20and%203.0%20Releases
NetBSD3.0 - missing space. (Also in many other places.)
- #Networking
ipsec-tools 0.6.2 - probably 0.6.3 now
- #Kernel
swwdog 4 - bad markup for man page reference
- #Libraries
"Support wide strings in C++" - missing period.
what about nsswitch dynamic modules?
- #Miscellaneous
audio 4 - bad markup.
list of 3rd party programs should not be part of audio(4) entry.
- #NetBSD/i386%20subdirectory%20structure
netbsd-GENERIC_DIAGNOSTIC.gz " gzipped NetBSD kernel containing code for
everything supported in this release, with diagnostic messages enabled."
- Is this true? I think that DISGNOSTIC is for diagnostic code,
not diagnostic messages.
there is also netbsd-GENERIC.MPACPI.gz and the XEN kernels.
- #Binary%20distribution%20sets
xserver
"The X server. This includes all XFree86 X servers."
- really are there more X servers currently?
- #Quick%20install
the screen shot shows NetBSD 2.0 sysinst.
- For configuring the X window system, if installed, see the files
in /usr/X11R6/lib/X11/doc. - isn't it better to recommend
X -configure?
- #Post%20installation%20steps
- the X window system
ditto.
- Installing third party packages:
"# PKG_PATH=ftp://ftp.NetBSD.org/pub/NetBSD/packages/3.0_RC1/.end-preformat" - WTF??
# mkdir /usr/pkgsrc
#( cd /usr/pkgsrc ; tar -zxpf - ) < pkgsrc.tar.gz
- missing space, inconsistent markup.
- #Upgrading%20a%20previously-installed%20NetBSD%20System
"it can be quite difficult to update the system from an earlier version by
recompiling from source" - is it really _that_ difficult nowadays, with
build.sh?
And in the alpha document:
ftp://ftp.netbsd.org/pub/NetBSD-daily/netbsd-3-0-RC1/200511171553Z/alpha/INSTALL.html
- #alpha%20specific
"There have been many alpha-specific enhancements since the NetBSD1.5
release." yes, but who cares about NetBSD1.5? :-)
Pavel Cahyna