
<!doctype html public "-//W3C//DTD W3 HTML//EN">

<html><head><style type="text/css"><!--

blockquote, dl, ul, ol, li { padding-top: 0 ; padding-bottom: 0 }

 --></style><title>javadoc for perl?</title></head><body>

<div>Is it hopeless?</div>

<div><br></div>

<div>I used to do a fair amount of java programming, and one of the

things I miss, when working on OO perl code, is javadoc (especially

working on someone else's OO perl!).</div>

<div><br></div>

<div>I don't know why, but pod format seems very unnatural to me for

documenting OO perl.  It reminds me more of nroff.  I prefer

having the doc more tightly coupled with

methods/packages/functions.</div>

<div><br></div>

<div>I've looked at some of the output from <a

href="http://search.cpan.org/~markov/OODoc-2.00/lib/OODoc.pod">OODoc</a

> and it seems to be headed in the right direction, but is not nearly

as nice as javadoc.  <a

href=

"http://perl.overmeer.net/mimetypes/html/jump.cgi?MIME_Types&42"

>Here</a> is some example output.</div>

<div><br></div>

<div>Thoughts?  Generate psuedo java code from OO perl and run it

through javadoc maybe?  Probably the other way (generate perl OO

from java class stubs with doc) would be easier, but I don't think it

is sellable to a perl development team.</div>

<div><br></div>

<div>-Russ</div>

</body>

</html>