Re^2: POD troubles

Replies are listed 'Best First'.
Re^3: POD troubles by Anonymous Monk on May 14, 2011 at 10:28 UTC
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	[reply] [d/l] [select]
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]