false promise of kwalitee

ishigaki on 2006-12-08T22:45:02

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.