in reply to Re^5: POD Standards
in thread POD Standards

Ok, point taken, you're right, POD's not perfect. What do you use instead?

Replies are listed 'Best First'.
Re^7: POD Standards
by Perl Mouse (Chaplain) on Jan 07, 2006 at 00:12 UTC
    I use three types of documentation: POD, mostly for Perl (and C and shell) programs, and only to generate manual pages from. LaTeX for most things that exceeds manual pages (long time ago, I used to use *roff and friends for that). And plain ASCII for anything else (and that's quite a lot).

    But to solve the problem of finding the right documentation, you need an index. (La)TeX is good in generating indices.

    Perl --((8:>*
Re^7: POD Standards
by BrowserUk (Patriarch) on Jan 06, 2006 at 22:22 UTC

    In previous lives, HTML and a decent html editor.

    If I were starting a project tomorrow, it would be doxygen.


    Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
    Lingua non convalesco, consenesco et abolesco. -- Rule 1 has a caveat! -- Who broke the cabal?
    "Science is about questioning the status quo. Questioning authority".
    In the absence of evidence, opinion is indistinguishable from prejudice.