On 16-May-98 Raul Miller playfully chanted:
| Personally, I kinda like pod (Perl's Plain Old Documentation) format.
|
| It's trivial to work with, and can produce man pages, html, text
| and latex.
|
| Plus, it ignores "other" stuff. So you can put docs in your .c file
| and you can pull out a man page (or whatever) fairly easily:
|
| =head1 NAME
|
| example - example of a pod document
|
| =head1 SYNOPSIS
|
| example line goes here
|
| =head1 DESCRIPTION
|
| Blah, blah, blah...
|
| =cut
|
| Presto, this email message is suitable for running through pod2html,
| pod2man, pod2text, ...
I'll check it out, because I think I've instantly become documentation-fixated.
But I was fairly impressed with the look of the postscript output I squeezed
out of sgml with (relatively) little effort. I'm not so pleased with the
actual text output because it generates overstrikes, but I'm working on a
filter for it that looks nicer.
---
[EMAIL PROTECTED]
Do we chase our tail or the moon when we follow the path of self-modification
with out objectivity?
-
To unsubscribe from this list send mail to: [EMAIL PROTECTED]
with the message contents: unsubscribe e-develop
