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