I was just browsing kwiki.org, and ran accross pdoc. The html (colorscheme) it generates is butt ugly, but it does do the auto-cross-linking/source-including feature you want. Check it out:

• http://pdoc.sourceforge.net/
• http://pdoc.sourceforge.net/Pdoc1.0/index.html -- example

UPDATE: Here's a patch for pdoc-1.0.tar.gz which will stop perlmod2www.pl from dying in the emiddle of its run.

--- Pdoc/Html/Renderers/PerlModule.pm    2004-08-15 04:47:10.359375000
+ -0700
+++ pdoc-1.0/Pdoc/Html/Renderers/PerlModule.pm    2002-03-15 09:42:54.
+000000000 -0800
@@ -792,7 +792,7 @@
                 print $fpt '<TR><TD>&nbsp;+&nbsp;<B>', $sub, '</B></T
+D>';
         
         # Got associated POD too?
-                if (eval{$subObj->get('pod')}) {
+                if ($subObj->get('pod')) {
                     print $fpt '<TD><A HREF="#_begpod', $begPod, '">D
+escription</A></TD>';
                     $begPod++;
                 } else {
@@ -831,7 +831,7 @@
                        '<TD>';
 
         # If doc
-            if (eval{$sub->get('pod')}) {
+            if ($sub->get('pod')) {
                 print $fpt '<A HREF="#POD', $podPos, '">Description</
+A>';
                 $podPos++;
             } else {
@@ -903,7 +903,7 @@
         # Write POD related to routines in BEGIN statement
             foreach my $sub (@{$entry->get('subroutines')}) {
                 my $subObj = $begins->fetch('PerlSub',$sub);
-                my $pod = eval {$subObj->get('pod')};
+                my $pod = $subObj->get('pod');
                 $begCode++;
         
                 next if (! $pod);
@@ -954,7 +954,7 @@
         # Write routines doc
         foreach my $entry (@sorted) {
             my $sub = $subroutines->fetch('PerlSub', $entry);
-            my $pod = eval{$sub->get('pod')};
+            my $pod = $sub->get('pod');
             $subPos++;
             next if (! $pod);
             
@@ -1053,9 +1053,9 @@
             print $fpt '<TABLE BORDER="0" WIDTH="100%" CELLSPACING="0
+">', "\n",
                        '<TR BGCOLOR="', $_config->{'subcode'}, 
                '"><TD WIDTH="200"><A NAME="CODE', $subPos, '"></A>',
-                       '<B>',eval{$sub->name()}||'noname', '</B></TD>
+';
+                       '<B>', $sub->name(), '</B></TD>';
 
-            my $pod = eval{$sub->get('pod')};
+            my $pod = $sub->get('pod');
             if ($pod) {
                 print $fpt '<TD><A HREF="#POD', $podPos, '">descripti
+on</A></TD>';
                 $podPos++;
@@ -1077,7 +1077,7 @@
             print $fpt '</TR></TABLE>', "\n";
         
             # Subroutine content
-            print $fpt eval{$sub->converted()}, "<BR>\n";
+            print $fpt $sub->converted(), "<BR>\n";
 
             $subPos++;
         }
[download]

---

---

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! —

• How do I compose an effective node title?
• How do I post a question effectively?
• Markup in the Monastery

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:
	&		&
	<		&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.