+1 I agree with using POD, which can easily be converted to actual man pages (yay!) or asciidoc as desired.
----- Original Message ----- > From: "Jason Stephenson" <[email protected]> > To: [email protected] > Sent: Friday, September 28, 2012 9:24:59 AM > Subject: Re: [OPEN-ILS-DEV] Code Documentation Proposal > > Quoting Dan Scott <[email protected]>: > > > Hmm. I'm curious about the choice of AsciiDoc format for the inline > > documentation; wouldn't POD markup make much more sense (so that > > "perldoc OpenILS::Actor::Friends" can return something)? Or is > > there a > > perldoc variant that understands AsciiDoc? > > +1 to using POD. > > > > -- > Jason Stephenson > Assistant Director for Technology Services > Merrimack Valley Library Consortium > Chief Bug Wrangler, Evergreen ILS > -- Chris Sharp PINES Program Manager Georgia Public Library Service 1800 Century Place, Suite 150 Atlanta, Georgia 30345 (404) 235-7147 [email protected] http://pines.georgialibraries.org/
