[Module::Build] [perl #39098] Pod::Html error stops CPAN install/test of Pod::Readme

[Tels <nos...@bl...>]

Moin,

"Randy W. Sims" <ml...@th...> wrote:

>Rafael Garcia-Suarez wrote:
[snip]
>> I'd say the problem is with Module::Build, which should probably
>> proceed if pod2html can't build HTML docs. Anyway this is a M::B bug,
>> not a Pod::Html one. The original POD document is actually malformed.

[snip]
>I think we should also test for these types of failures for the author=20
>during 'disttest' or at some other point where the author can correct=20
>the problem before the user sees it. Any preference as to where to put=20
>such tests?

That is the reasoning behind having every distribution pod (pod exists and=
=20
is wellformed) and pod coverage tests (pod covers all public methods in=20
some form).

Not having them is a Kwalitee malus.

However, this is not "enforced", read every author is free to not test his=
=20
pod at all (or even include one). Including broken POD is an "oops" just=20
like not running "make disttest" (and thus forgetting a file in MANIFEST)=20
or any similiar mistakes every author makes regulary. I am not sure how=20
we can improve the situation except make it much much easier for authors=20
to write (and run) these tests.

I am thinking of a command line version of the kwalitee script, that=20
checks the rating, and gives tipps on how to improve it, or even auto=20
generated the t/podcheck.t and t/podcover.t files (among other things).

Unfortunately, the CPANTS project seems stuck atm :(

Best wishes,

Tels

=2D-=20
 Signed on Mon May 15 14:42:57 2006 with key 0x93B84C15.
 Visit my photo gallery at http://bloodgate.com/photos/
 PGP key on http://bloodgate.com/tels.asc or per email.

 "Wo die Schoschonen sch=C3=B6n wohnen."