On Wednesday 17 March 2004 16:07, you wrote:
> Hi,
>
> I was wondering what tools (if any) people were using for writing man
> pages for their FOSS projects.
>
> Shachar
I'm using the perl POD (Plain Old Documentation) suite of tools. You write in
one common format and then convert it to many other formats (there's
pod2text, pod2man, pod2html, pod2latex, pod2docbook, etc.)
I've learned about it from the mhash project which used it for their man page.
Just type "perldoc perlpod" and you'll be able to learn it quickly. It's
better than using troff directly, because you can later convert it to many
other formats.
POD also has the advantage that if the document looks fine you can almost be
certain it will be converted well to all the resultant formats. It's also
very simple and clean.
Regards,
Shlomi Fish
--
---------------------------------------------------------------------
Shlomi Fish [EMAIL PROTECTED]
Homepage: http://shlomif.il.eu.org/
Quidquid latine dictum sit, altum viditur.
[Whatever is said in Latin sounds profound.]
=================================================================
To unsubscribe, send mail to [EMAIL PROTECTED] with
the word "unsubscribe" in the message body, e.g., run the command
echo unsubscribe | mail [EMAIL PROTECTED]
