Re: Just my opinion
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 <ironfoot@popaccount.com>
--> 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.
Reply to: