[Pdx-pm] Starting from scratch with Module::Build

Marvin Humphrey marvin at rectangular.com
Fri Jul 1 16:10:05 PDT 2005


Schwern writes:
> I honestly don't bother with things like h2xs (especially h2xs)  
> because
> their templates tend to make things seem WAY more complicated than  
> they
> really are by providing "fill in the blanks" for all sorts of stuff  
> you're
> unlikely to need.  I think h2xs has contributed greatly to the  
> "writing
> modules is hard" myth.

Hmm.

Shouldn't writing modules, at least for CPAN, be a _little_ hard, or  
more precisely, a little involved?  How much of the stuff that comes  
out of h2xs or module-starter is fluff?  Finding stuff on CPAN is  
already pretty annoying, because there are so many half-assed modules  
with inadequate documentation, tests, commenting, etc.

I _like_ the idea that module writers who fail to alter the stub  
documentation open themselves to ridicule.

http://search.cpan.org/search?query=blah+blah+blah

In fact, I'd like to see Pod::Coverage, and maybe Test::Coverage  
results integrated into the search interface.  Filter my results to  
eliminate garbage like this, please:

http://search.cpan.org/~sburke/Pod-Simple-3.02/lib/Pod/Simple/HTML.pm
http://search.cpan.org/~simon/Plucene-SearchEngine-1.1/lib/Plucene/ 
SearchEngine.pm

As someone who takes documentation and QC seriously, I appreciate  
having a template prepared for me that errs on the side of excess.

Marvin Humphrey
Rectangular Research
http://www.rectangular.com/



More information about the Pdx-pm-list mailing list