Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

TorgoX (1933)

TorgoX
  sburkeNO@SPAMcpan.org
http://search.cpan.org/~sburke/

"Il est beau comme la retractilité des serres des oiseaux rapaces [...] et surtout, comme la rencontre fortuite sur une table de dissection d'une machine à coudre et d'un parapluie !" -- Lautréamont

Journal of TorgoX (1933)

Friday November 09, 2001
08:42 PM

markup modules I've written

[ #1221 ]
Dear log,

Weirdest module I've ever written: Pod::HTML2Pod. Yes, it turns HTML into Pod. Write your documentation in HTML, and turn it into Pod. The source code is horrendous, tho.

Module whose design I put the most thought into: Pod::PXML. It turns Pod into an XML instance, and back. The hard part was the specifics of the instance's doctype. What a "=item" looks like, etc.

Hard because there's so many ways to do it; some better for some things, some better for others. Compare its doctype to the much more verbose doctype from Matt Sergeant's Pod::XML. Now that I've written perlpodspec and gotten pod more sorted in my mind, I'm beginning to think Pod::PXML should be a tiny bit more like Pod::XML's doctype. Notably, now that I have stipulated all the kinds of "=over...=back" regions there are, and decided that the first paragraph after the =over should dictate the type, I sort of wish that an "=over / =item * ... =back" region would turn into different elements than an "=over =item 1. ... =back" region would. Maybe next time. First to fix some annoyances in Pod::Tree, I guess.