Re^3: POD troubles

That is the trouble with pod2html, it is old and parses pod raw by itself, and its not exactly perlpodspec compliant. Better alternatives are Pod::Simple::HTML/Pod::Simple::HTMLBatch or for a perl "-V:.*?html.*?" free experience, Pod::POM::Web

I noticed you released http://search.cpan.org/~dlugosz/HTML-EntityReference-0.010/, but your t/pod.t doesn't have

unless ( $ENV{AUTOMATED_TESTING} or $ENV{RELEASE_TESTING} ) {
    plan( skip_all => "Author tests not required for installation" );
}
[download]

as per Test::XT - Best Practice for Author Tests

Comment on Re^3: POD troubles Select or Download Code

Replies are listed 'Best First'.
Re^4: POD troubles by John M. Dlugosz (Monsignor) on May 14, 2011 at 11:28 UTC
Thanks. This t/pod.t was created by module-simple. I noticed lines like that "author test" skip in other files it supplied. So, the pod2html, which is apparently what is being used by `./Build html`, uses a tool that is indeed one of "those old parsers" and is not updated with current libraries, even though it is CORE. So, I just need to get Build to use the modern one, or ignore the availability of that Build verb. And can I surmise that CPAN's Search page uses a modern one? Thanks for the link to Best Practice, whoever you are. I'll read that next. As long as you seem to be the first to notice my module, perhaps you can further criticize it? It's my first CPAN upload in many years. I'm not sure what was going on with Manifest and ignore.txt vs. MANIFEST.ignore files?	[reply] [d/l]

Replies are listed 'Best First'.

Re^4: POD troubles
by John M. Dlugosz (Monsignor) on May 14, 2011 at 11:28 UTC

So, the pod2html, which is apparently what is being used by ./Build html, uses a tool that is indeed one of "those old parsers" and is not updated with current libraries, even though it is CORE.

So, I just need to get Build to use the modern one, or ignore the availability of that Build verb. And can I surmise that CPAN's Search page uses a modern one?

Thanks for the link to Best Practice, whoever you are. I'll read that next.

As long as you seem to be the first to notice my module, perhaps you can further criticize it? It's my first CPAN upload in many years. I'm not sure what was going on with Manifest and ignore.txt vs. MANIFEST.ignore files?

[reply]
[d/l]