On Thu, Jun 11, 2009 at 3:46 AM, Ovid <[email protected]>wrote:
> > What would be nice if if the main documentation ( > http://search.cpan.org/dist/Module-Build/lib/Module/Build.pm) had, right > at the top, sample Build.PL code in the synopsis. After that, maybe a few > "optional" configurations or "recommended" Build.PL files. For example, > here's a sample Build.PL that I'm using and the various features are ones > that I learned from mailing lists because I get lost in the docs :) > [...] > I suspect, but can't prove, that many potential Module::Build users have > the same issues. They just want to know how to write a useful Build.PL. > Maybe after that a quick example of how to extend it to, say, set up a test > database or some other build action. Then and only then go into the > mind-numbing detail about every single bell and whistle that Module::Build > provides :) > +1. If you really want people to adopt Module::Build, change the h2xs script so it generates something like the above... (kidding - does anyone still use h2xs to start a non-xs module?)
