On Sunday 21 Sep 2003 7:37 pm, David Filion wrote: > Richard Urwin wrote: > > On Sunday 21 Sep 2003 3:22 pm, Aron Smith wrote: > >>** The one thing that Programmers are NOT good at is > >> Documentation. That's why Tech Writers exist (unfortunately the > >> good ones find out that writing Science Fiction pays better :-( > >> ). > > > > As a programmer: > > > > Documenting a program is a good and worthwhile activity; like > > going to the dentist. However documentation is like sex; when > > it's good it's wonderful, and when it's bad it's still better > > than nothing. > > man pages are not meant to be a hand holding how-to document > (though recently, some apps are using them as such). If you want > to know how to use a command/app, read a how-to, do a google from > a tutorial, don't read the man page. man pages are meant to > refresh you memory about a command's function and it's options.
which is where they are great. So please, don't tell newbies that they are the first port of call. Anne -- Registered Linux User No.293302 Have you visited http://twiki.mdklinuxfaq.org yet?
Want to buy your Pack or Services from MandrakeSoft? Go to http://www.mandrakestore.com