All the Perl that's Practical to Extract and Report

Pod::Simple::HTML vs Pod::Parser + Pod::HTML_Elements

gbarr on 2003-09-03T15:41:26

Several people in the past have asked me what code was used to render POD on search.cpan.org. My response has always been "A hacked version of Pod::HTML_Elements"

Then Sean wrote the Pod::Simple modules and my response became "A hacked version of Pod::HTML_Elements, but use Pod::Simple".

Today I finally changed search over to using Pod::Simple::HTML, with a few modifications, which has resulted in a speedup of more than 5x in rendering POD pages. The changes I made have been sent to Sean and will hopefully be in the next release.

cache

bart on 2003-09-03T18:11:13

which has resulted in a speedup of more than 5x in rendering POD pages
Isn't the output of rendering these pages, cached on disk? You know, like Template Toolkit caches its conversion of templates to perl.

If so, then the actual rendering time of each page doesn't matter as much.

Re:cache

ask on 2003-09-03T19:59:42

They are presumably not cached forever. And even if they are, there's still the first hit on any given page.

Re: Pod::Simple::HTML

jmcnamara on 2003-09-03T22:23:54

Neat. It even adds a POD ERRORS section.

Do your mods include TOC support?

grantm on 2003-09-04T09:00:24

The changes I made have been sent to Sean and will hopefully be in the next release.

Does that mean you've hacked Table of Contents support into Pod::Simple::HTML - or does it already support that and I'm just not smart enough to make it do it?

Re:Do your mods include TOC support?

gbarr on 2003-09-04T10:04:32

Yes, my patch I sent to Sean does include support for TOC