-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 The Tuesday 2006-04-25 at 15:40 +0200, houghi wrote:
On Tue, Apr 25, 2006 at 03:02:59PM +0200, jdd wrote:
but a man mapge is just that: a remainder of commands
For me `an interface to the on-line reference manuals` is more then just a list of -v, -h, -l and so on.
For me, a man page is a manual: all information needed to use a program without need to read a paper manual. From the simple to the complex. If too complex, then use "info" pages instead, or added. It must include the syntax, some examples, and descriptions. If they don't like "info", then use html, but include an exact link in a small man page (some do this).
One of the best manpages is, I think, fetchmail. Especially the part "CONFIGURATION EXAMPLES". I learned more from that chapter on how to use it then from any other part of the manpage.
Another good one is "procmail", except that the examples are separated in "man procmailex". And a curious "-h" one is "smartctl": it gives examples. - -- Cheers, Carlos Robinson -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.0 (GNU/Linux) Comment: Made with pgp4pine 1.76 iD8DBQFETjjUtTMYHG2NR9URAhnXAJwPVKxgTT1IfSZm9HFZfZanPiat7gCggbKS 35WvZR5uxcmvy5Rg0IAjWrY= =P7tX -----END PGP SIGNATURE-----