All the Perl that's Practical to Extract and Report
use Perl Log In
aaronelliotross (6732)
aaronelliotross
(email not shown publicly)
Aaron works at We Also Walk Dogs on web, email and database systems for various clients.
(email not shown publicly)
Aaron works at We Also Walk Dogs on web, email and database systems for various clients.
Journal of aaronelliotross (6732)
Tuesday March 07, 2006
06:16 AM
Building Local Documentation
I recently wrote a few scripts to generate HTML documentation from our library and scripts.
I was surprised how hard it was to get links from one page to another to target methods correctly. It's not really suprising though, since POD knows nothing about methods.
In the end, I used scripts based on the Krang doc building tools to munge the output of pod2html. I took links to #sections and made them #item_section since we have a convention of putting methods in =over/=back lists.
Likely to break, but works for now.
Fooled me :-) Maybe the Perlian sentence modifier style has crept into
your C...? I know that I often stare at the C compiler moaning about
my perfectly sensible 'print "$p\n";'...
-- Jarkko Hietaniemi
Stories, comments, journals, and other submissions on use Perl; are Copyright 1998-2006, their respective owners.
