doxygen parses sourcecode to determine constants, function signatures, etc.. function signature won't work for perl (as i'm sure you realize).

doxygen includes hyperlinked syntaxt hilighted sourcecode in its output, and there is no reason you couldn't do that with perl other than its of little use most of the time (and parsing perl is hard).

doxygen links all function references to the function documentation, and there's no reason a pod translator couldn't do that (in fact Pod::Html tries to resolve those when possible).

Anyway, here is something other than just pod:

Anyway, perl's only issue with pod (besides the fact that L<blah blah|http://some.url/> isn't legal yet), is that there aren't many tools (like doxygen) to generate pod from raw source (as much is possible) for module writers (module users shouldn't need to deal with such tools).

BTW - I like pod :)

MJD says "you can't just make shit up and expect the computer to know what you mean, retardo!"
I run a Win32 PPM repository for perl 5.6.x and 5.8.x -- I take requests (README).
** The third rule of perl club is a statement of fact: pod is sexy.

In reply to Re: documentation generator? web-enabled perldoc? by PodMaster
in thread documentation generator? web-enabled perldoc? by geektron

Title:
Use:  <p> text here (a paragraph) </p>
and:  <code> code here </code>
to format your post, it's "PerlMonks-approved HTML":


  • Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!
  • Titles consisting of a single word are discouraged, and in most cases are disallowed outright.
  • Read Where should I post X? if you're not absolutely sure you're posting in the right place.
  • Please read these before you post! —
  • Posts may use any of the Perl Monks Approved HTML tags:
    a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr
  • You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)
            For:     Use:
    & &amp;
    < &lt;
    > &gt;
    [ &#91;
    ] &#93;
  • Link using PerlMonks shortcuts! What shortcuts can I use for linking?
  • See Writeup Formatting Tips and other pages linked from there for more info.