On Tue, Jul 06, 1999 at 07:31:01AM -0400, Ipswitch wrote: > > > On Mon, 5 Jul 1999, Brad wrote: > > > > the documentation is incomplete, out of date, or simply wrong, > > > > You have a bit of a point there. Some of the HOWTOs are rather old and > > inaccurate, mostly because they were written a few years ago and there've > > been many advances since then. Most of the manpages on the other hand are > > relatively up-to-date, and many of the more complicated packages even come > > with examples (look in /usr/doc/[packagename]). > > The GNU manpages are really bad. Most just tell you that you shouldn't use > them - use info instead. Yuck! >
Or even worse, a manpage that says nothing but 'read the html docs in /usr/doc/<whatever>'... IMHO, this is not a solution to the policy requiring a manpage. Manpages should *at least* show the syntax and available options for the command. At that point, a reference to more thorough documentation would be acceptable. Mike -- Michael Merten <[EMAIL PROTECTED]> --> NRA Life Member (http://www.nra.org) --> Debian GNU/Linux Fan (http://www.debian.org) --> CenLA-LUG Member (http://www.angelfire.com/la2/cenlalug) -- A little experience often upsets a lot of theory.