On Mon, 17 Feb 2003, Jason R. Mastaler wrote: > > So, are you interested in a man page contribution? > > My worry is that they will be redundant in the face of the --help > output, and thus I'll need to make updates in two places from then on.
Without addressing the question of necessity... you could use something like the pod format (run "perldoc perlpod.pod" on your favorite system with Perl installed) as the base, and then use conversion tools like pod2man and pod2html to generate the documentation in various forms. This would save you the trouble of duplicate updates, and establish the documentation in a standard format that could be converted to whatever other format a given user might find useful. You could also then remove the detailed documentation from the program scripts, a good thing from some perspectives. I think the average user is fairly accustomed to the concept of man pages, so I think we could reasonably expect them to try "man tmda-pending" before throwing their arms up in despair and disgust, and possibly even before typing "tmda-pending --help". Chris _________________________________________________ tmda-workers mailing list ([EMAIL PROTECTED]) http://tmda.net/lists/listinfo/tmda-workers
