Slash Boxes
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 ]

Matts (1087)

  (email not shown publicly)

I work for MessageLabs [] in Toronto, ON, Canada. I write spam filters, MTA software, high performance network software, string matching algorithms, and other cool stuff mostly in Perl and C.

Journal of Matts (1087)

Friday December 27, 2002
12:14 PM

Pod Parsing

[ #9643 ]

Today I had another look at POD parsing - there are a few small bugs in Pod::SAX's parsing of L<> items that are inherited from Pod::Parser. For example it won't correctly parse L<< A link with a file reference: F<foo/bar> >> because it treats the "/" as a L<> separator, then barfs because it sees the F< part and tries to treat it as a File reference, but can't find the end of it because the L<> parser swallowed it. All too horrible (and confusing to describe - so I don't expect readers to grok it any more than I do!). Basically what needs to be done is treat the text inside the L<> as the post-processed text equivalent after stripping all sequences inside. Unfortunately my parser doesn't provide me access to all that, and I'm not sure I'm up to the job of re-writing all the internals.

In short, I think it might be time to port Pod::SAX to using Pod::Simple instead of Pod::Parser. Though only because that might be the lesser of the two evils ;-)

"time" of course is relative. I don't exactly need that feature, and I'm sure there are very few users of Pod::SAX (aside from those who might use the AxKit Wiki) so it's very much non-urgent. Maybe I'll file myself a bug report in RT ;-)

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
More | Login | Reply
Loading... please wait.
  • I'd love if you did a SAX interface to Pod::Simple ! You'll probably notice that the basic Pod::Simple interface is already pretty SAX-like, so I just needed someone to come by and put a proper SAX wrapper around it. I think SAX is great, but I'm not totally familiar with every last detail of it, so I shyed away from being the one to actually do up the Pod::Simple::SAX, since I didn't want to make a mess of it.

    Feel free to email me any questions you might have about some of the less well-documented parts