On Monday 30 June 2008 15:03:14 David Cantrell wrote: > On Mon, Jun 30, 2008 at 11:42:23PM +0200, Aristotle Pagaltzis wrote:
> > (The problem is that one of the aspects of kwalitee was supposed > > to be that the module is properly documented ??? regardless of how > > good the documentation is, it should follow proper form, at > > least. Unfortunately, since a design goal for CPANTS is not to > > run any code from the distro, testing POD coverage and even POD > > itself is not actually doable because you don???t know what the API > > will look like at runtime (AUTOLOAD, autogenerated functions or > > methods, etc etc etc). > Surely you can at least check that all POD is "well-formed" without > running any code from the distribution in question? Sure, but that's a very different question from "Did the author write useful documentation for everything that needs public documentation?", as "Are there any POD errors?" is statically determinable. "What do useful, proper, public, and everything mean?" is not. -- c
