- Original Message
From: Ken Williams kena...@gmail.com
On Tue, May 12, 2009 at 9:06 AM, Eric Wilhelmwrote:
Isn't that what Ken did some time ago? Ah... 0.31 added
the create_license = 1 option, but I guess it didn't get documented.
Oopsie. Yeah.
create_license = 1,
create_readme = 1,
and Bob's your uncle.
I only learned about the 'create_readme' option a few days ago when I was
browsing the CPAN.
I can't speak for most others, but even though I've done some pretty serious
things with Module::Build (and I absolutely love it), I'm guessing that my
common usage ( 95% of the modules I write) matches everyone else's common
usage: writing a simple Build.PL
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 :)
use Module::Build;
my $builder = Module::Build-new(
module_name= 'AI::Logic',
license= 'perl',
dist_author= 'Curtis Ovid Poe o...@cpan.org',
dist_version_from = 'lib/AI/Logic.pm',
build_requires = { 'Test::Most' = 0.21, },
requires = { 'Scalar::Util' = 1.19, },
add_to_cleanup = ['AI-Logic-*'],
create_readme = 1,
create_makefile_pl = 'traditional',
);
$builder-create_build_script();
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 :)
Cheers,
Ovid
--
Buy the book - http://www.oreilly.com/catalog/perlhks/
Tech blog- http://use.perl.org/~Ovid/journal/
Twitter - http://twitter.com/OvidPerl
Official Perl 6 Wiki - http://www.perlfoundation.org/perl6