Beefy Boxes and Bandwidth Generously Provided by pair Networks
laziness, impatience, and hubris
 
PerlMonks  

Re^3: POD troubles

by Anonymous Monk
on May 14, 2011 at 10:28 UTC ( [id://904801]=note: print w/replies, xml ) Need Help??


in reply to Re^2: POD troubles
in thread 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

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]

In Section Seekers of Perl Wisdom

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?

www.com | www.net | www.org
Node Status?
node history
Node Type: note [id://904801]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this? • Last hour • Other CB clients
Other Users?
Others contemplating the Monastery: (4)
As of 2024-04-19 15:58 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found