Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

use Perl Log In

Log In

[ Create a new account ]

ishigaki (7238)

ishigaki
  (email not shown publicly)
http://ppm.tcool.org/

Journal of ishigaki (7238)

Friday December 08, 2006
05:45 PM

false promise of kwalitee

[ #31861 ]

There are lots of things that make me crazy while packaging modules for my ppm repos, but one of the worst irritators is a podcoverage test failure.

I believe the test should guarantee the kwalitee of a package, but testing pod is not so critical for ordinary people, so lots of the tests are written to be skipped unless TEST_POD env is true. Actually, some of my modules have such tests. I once thought that was an idea.

However, I've found not a few podcoverage tests which see TEST_POD are broken. I reported some of them via RT but, unlike other explicit failures, completing pod entries is not so easy. Just reporting a broken test makes me feel sorry, but there's no right answer for a pod, especially for a non-native English speaker like me.

So, I beg you, who probably have just copied your podcoverage test from somewhere. Set TEST_POD or remove the test. Otherwise, your test might be a false promise of kwalitee.

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.