NAME
Dist::Zilla::PluginBundle::Author::DOHERTY - configure Dist::Zilla like
DOHERTY
VERSION
version 0.34
SYNOPSIS
# in dist.ini
[@Author::DOHERTY]
DESCRIPTION
"Dist::Zilla::PluginBundle::Author::DOHERTY" provides shorthand for a
Dist::Zilla configuration that does what Mike wants.
USAGE
Just put "[@Author::DOHERTY]" in your dist.ini. You can supply the
following options:
* "custom_build" specifies to use
Dist::Zilla::Plugin::ModuleBuild::Custom instead of generating
boilerplate ExtUtils::MakeMaker and Module::Build build tools.
* "fake_release" specifies whether to use "FakeRelease" instead of
"UploadToCPAN".
Default is false.
* "enable_tests" is a comma-separated list of testing plugins to add
to "TestingMania".
Default is none.
* "disable_tests" is a comma-separated list of testing plugins to skip
in "TestingMania".
Default is none.
* "tag_format" specifies how a git release tag should be named. This
is passed to "Git::Tag".
Default is " %v%t ".
* "version_regexp" specifies a regexp to find the version number part
of a git release tag. This is passed to "Git::NextVersion".
Default is "^(v.+)$".
* "twitter" says whether releases of this module should be tweeted.
Default is true.
* "surgical" says to use Dist::Zilla::Plugin::SurgicalPodWeaver.
Default is false.
* "max_target_perl" is the highest minimum version of perl you intend
to require. This is passed to
Dist::Zilla::Plugin::Test::MinimumVersion, which generates a
minimum-version.t test that'll warn you if you accidentally used
features from a higher version of perl than you wanted. (Having a
lower required version of perl is okay.)
* "changelog" is the filename of the changelog.
Default is Changes.
* "push_to" is the git remote to push to; can be specified multiple
times.
Default is "origin".
* "github" is a boolean specifying whether to use the plugins
Dist::Zilla::Plugin::GitHub::Meta and
Dist::Zilla::Plugin::GitHub::Update.
* "critic_config" is a filename to pass through to
Dist::Zilla::Plugin::Test::Perl::Critic.
* "googlecode_project" tells UploadToGoogleCode which project to
upload to. This is required if you want to upload your release to
Google Code.
* "fork_is_authoritative" tells GitHub::Meta that your fork is
authoritative. That means that the repository, issues, etc will
point to your stuff on github, instead of wherever you forked from.
This is useful if your repository on Github is a fork, but you have
taken over maintaining the module, so people should probably send
bug reports to you instead of the original author, and should fork
from your repo, etc.
* "release_to" is a string that specifies where to send the release.
Valid release targets are:
* PAUSE (or CPAN)
We'll use UploadToPAUSE to do the release, and clean up
afterwards. This is the default
* GoogleCode
Well use UploadToGoogleCode to do the release, and clean up
afterwards. Make sure you set "googlecode_project"
* local
We will do all the releasey things like tagging and pushing and
whatnot, but we won't do any releasing things, and we won't
clean up. This leaves the release tarball sitting there for you
to do with as you will.
In the future, there might be an option to scp the tarball
somewhere.
* "has_version" and "strict_version" set options in
Dist::Zilla::PluginBundle::TestingMania, which passes them along to
Dist::Zilla::Plugin::Test::Version and thus Test::Version. They set
"has_version" and "is_strict" respectively.
COMMAND LINE OPTIONS
"--fake-release"
Do a fake release.
"--release-to"
Specify release targets - can be specified multiple times.
"--offline"
Don't do things that need a network connection: sets "github" and
"twitter" to false; sets "push_to" to an empty array ref (ie: don't
push anywhere); and sets "release_to" to local.
ENVIRONMENT
* "NO_TEST"
If true, doesn't add TestRelease or CheckExtraTests.
SEE ALSO
"Dist::Zilla"
AVAILABILITY
The latest version of this module is available from the Comprehensive
Perl Archive Network (CPAN). Visit to find a
CPAN site near you, or see
.
BUGS AND LIMITATIONS
You can make new bug reports, and view existing ones, through the web
interface at .
AUTHOR
Mike Doherty
COPYRIGHT AND LICENSE
This software is copyright (c) 2010 by Mike Doherty .
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.