Re: man pages
>From: Jan Schaumann <jschauma@netmeister.org>
>> I don't think that man-pages should be standarized:
>> - we can only specify them for LSB applications and not for a complete
>> system (that would be part of FHS)
>> - most LSB applications will not come with man pages at all
>Any program *should* come with a man-page, IMHO. I feel strongly that
>this ought to be part of the LSB. How often have you had to search for
>documentation because the man-page was not available or unreadable or
>badly written?
100% agreed!
A man page is the default dodumentation. Any other documentation is optional.
Any program must have a man page that will describe all functions and all
options.
Programs that don't have one or where it is incomplete should not be a part
of the base distribution.
Jörg
EMail:joerg@schily.isdn.cs.tu-berlin.de (home) Jörg Schilling D-13353 Berlin
js@cs.tu-berlin.de (uni) If you don't have iso-8859-1
schilling@fokus.gmd.de (work) chars I am J"org Schilling
URL: http://www.fokus.gmd.de/usr/schilling ftp://ftp.fokus.gmd.de/pub/unix
Reply to: