<html><head><title>Dist::Zilla::PluginBundle::Author::BBYRD</title>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" >
</head>
<body class='pod'>
<!--
  generated by Pod::Simple::HTML v3.20,
  using Pod::Simple::PullParser v3.20,
  under Perl v5.016000 at Wed Oct 17 17:56:46 2012 GMT.

 If you want to change this HTML document, you probably shouldn't do that
   by changing it directly.  Instead, see about changing the calling options
   to Pod::Simple::HTML, and/or subclassing Pod::Simple::HTML,
   then reconverting this document from the Pod source.
   When in doubt, email the author of Pod::Simple::HTML for advice.
   See 'perldoc Pod::Simple::HTML' for more info.

-->

<!-- start doc -->
<a name='___top' class='dummyTopAnchor' ></a>

<h1><a class='u'
name="NAME"
>NAME</a></h1>

<p>Dist::Zilla::PluginBundle::Author::BBYRD - DZIL Author Bundle for BBYRD</p>

<h1><a class='u'
name="SYNOPSIS"
>SYNOPSIS</a></h1>

<pre>    ; Very similar to...
 
    [ReportPhase]
 
    ; Makefile.PL maker
    [MakeMaker]
 
    [Git::NextVersion]
    first_version = 0.90
 
    [Git::GatherDir]
 
    ; File modifiers
    [OurPkgVersion]
    [PodWeaver]
 
    ; File pruners
    [PruneCruft]
 
    ; Extra file creation
    [GitFmtChanges]
    [ManifestSkip]
    [Manifest]
    [License]
    [ReadmeAnyFromPod / ReadmeHtmlInBuild]
    [ReadmeAnyFromPod / ReadmePodInBuild]
    [InstallGuide]
    [ExecDir]
 
    ; t/* tests
    [Test::Compile]
 
    ; POD tests
    [PodCoverageTests]
    [PodSyntaxTests]
    ;[Test::PodSpelling]  ; Win32 install problems
 
    ; Other xt/* tests
    [RunExtraTests]
    ;[MetaTests]  ; until Test::CPAN::Meta supports 2.0
    [NoTabsTests]
    [Test::EOL]
    trailing_whitespace = 0
 
    [Test::CPAN::Meta::JSON]
    [Test::CheckDeps]
    [Test::Portability]
    ;[Test::Pod::LinkCheck]  ; Both of these are borked...  
    ;[Test::Pod::No404s]     ; ...I really need to create my own
    [Test::Synopsis]
    [Test::MinimumVersion]
    [ReportVersions::Tiny]
    [Test::CheckManifest]
    [Test::DistManifest]
    [Test::UseAllModules]
    [Test::Version]
 
    ; Prereqs
    [@Prereqs]
    minimum_perl = 5.10.1
 
    [CheckPrereqsIndexed]
 
    ; META maintenance
    [MetaConfig]
    [MetaJSON]
    [MetaYAML]
 
    [MetaNoIndex]
    directory = t
    directory = xt
    directory = examples
    directory = corpus
 
    [MetaProvides::Package]
    meta_noindex = 1        ; respect prior no_index directives
 
    [MetaResourcesFromGit]
    x_irc          = irc://irc.perl.org/#distzilla
    bugtracker.web = https://github.com/%a/%r/issues
 
    ; Post-build plugins
    [CopyFilesFromBuild]
    move = .gitignore
    copy = README.pod
 
    ; Post-build Git plugins
    [TravisYML]
    test_min_deps = 1
 
    [Git::CheckFor::CorrectBranch]
    [Git::CommitBuild]
    release_branch = build/%b
    release_message = Release build of v%v (on %b)
 
    [@Git]
    allow_dirty = dist.ini
    allow_dirty = .travis.yml
    allow_dirty = README.pod
    changelog =
    commit_msg = Release v%v
    push_to = origin
    push_to = origin build/master:build/master
 
    [GitHub::Update]
    metacpan = 1
 
    [TestRelease]
    [ConfirmRelease]
    [UploadToCPAN]
    [InstallRelease]
    [Clean]
 
    ; PodWeaver deps
    ; authordep Pod::Weaver::Plugin::WikiDoc
    ; authordep Pod::Weaver::Plugin::Encoding
    ; authordep Pod::Weaver::Section::Availability
    ; authordep Pod::Weaver::Section::Support
    ; authordep Pod::Elemental::Transformer::List
 
    ; sanity deps
    ; authordep autovivification
    ; authordep indirect
    ; authordep multidimensional</pre>

<h1><a class='u'
name="DESCRIPTION"
>DESCRIPTION</a></h1>

<p><a href="http://search.cpan.org/perldoc?sanity" class="podlinkpod"
>I frelling hate these things</a>, but several releases in, I found myself needing to keep my <code>dist.ini</code> stuff in sync, which requires a single module to bind them to.</p>

<h1><a class='u'
name="NAMING_SCHEME"
>NAMING SCHEME</a></h1>

<p>I&#39;m a strong believer in structured order in the chaos that is the CPAN namespace. There&#39;s enough cruft in CPAN, with all of the forked modules, legacy stuff that should have been removed 10 years ago, and confusion over which modules are available vs. which ones actually work. (Which all stem from the same base problem, so I&#39;m almost repeating myself...)</p>

<p>Like I said, I hate writing these personalized modules on CPAN. I even bantered around the idea of using <a href="https://github.com/SineSwiper/Dist-Zilla-PluginBundle-BeLike-You/blob/master/BeLike-You.pod" class="podlinkurl"
>MetaCPAN&#39;s author JSON input</a> to store the plugin data. However, keeping the Author plugins separated from the real PluginBundles is a step in the right direction. See <a href="http://search.cpan.org/perldoc?Dist%3A%3AZilla%3A%3APluginBundle%3A%3AAuthor%3A%3AKENTNL#NAMING-SCHEME" class="podlinkpod"
>KENTNL&#39;s comments on the Author namespace</a> for more information.</p>

<h1><a class='u'
name="CAVEATS"
>CAVEATS</a></h1>

<p>This uses <a href="http://search.cpan.org/perldoc?Dist%3A%3AZilla%3A%3ARole%3A%3APluginBundle%3A%3AMerged" class="podlinkpod"
>Dist::Zilla::Role::PluginBundle::Merged</a>, so all of the plugins&#39; arguments are available, using Merged&#39;s rules. Special care should be made with arguments that might not be unique with other plugins. (Eventually, I&#39;ll throw these into <code>config_rename</code>.)</p>

<p>If this is a problem, you might want to consider using <a href="http://search.cpan.org/perldoc?Dist%3A%3AZilla%3A%3APluginBundle%3A%3AFilter" class="podlinkpod"
>@Filter</a>.</p>

<p>One exception is <code>x_irc</code>, which is detected and passed to <a href="http://search.cpan.org/perldoc?Dist%3A%3AZilla%3A%3APlugin%3A%3AMetaResourcesFromGit" class="podlinkpod"
>MetaResourcesFromGit</a> properly.</p>

<h1><a class='u'
name="SEE_ALSO"
>SEE ALSO</a></h1>

<p>In building my ultimate <code>dist.ini</code> file, I did a bunch of research on which modules to cram in here. As a result, this is a pretty large set of plugins, but that&#39;s exactly how I like my DZIL. Feel free to research the modules listed here, as there&#39;s a bunch of good modules that you might want to include in your own <code>dist.ini</code> and/or Author bundle.</p>

<p>Also, here&#39;s my <code>profile.ini</code>, if you&#39;re interested:</p>

<pre>    [TemplateModule/:DefaultModuleMaker]
    template = Module.pm
 
    [DistINI]
    append_file = plugins.ini
 
    [GatherDir::Template]
    root = skel
 
    [GenerateFile / Generate-.gitignore]
    filename = .gitignore
    is_template = 1
    content = MANIFEST
    content = MANIFEST.bak
    content = Makefile
    content = Makefile.old
    content = Build
    content = Build.bat
    content = META.*
    content = MYMETA.*
    content = .build/
    content = _build/
    content = blib/
    content = inc/
    content = .lwpcookies
    content = .last_cover_stats
    content = nytprof.out
    content = pod2htm*.tmp
    content = pm_to_blib
    content = {{$dist-&#62;name}}-*
    content = {{$dist-&#62;name}}-*.tar.gz
 
    [Git::Init]
    commit_message = Initial commit
 
    [GitHub::Create]</pre>

<h1><a class='u'
name="TODO"
>TODO</a></h1>

<p>Create a <a href="http://search.cpan.org/perldoc?Pod%3A%3AWeaver" class="podlinkpod"
>Pod::Weaver</a> author bundle.</p>

<h1><a class='u'
name="AVAILABILITY"
>AVAILABILITY</a></h1>

<p>The project homepage is <a href="https://github.com/SineSwiper/Dist-Zilla-PluginBundle-Author-BBYRD/wiki" class="podlinkurl"
>https://github.com/SineSwiper/Dist-Zilla-PluginBundle-Author-BBYRD/wiki</a>.</p>

<p>The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit <a href="http://www.perl.com/CPAN/" class="podlinkurl"
>http://www.perl.com/CPAN/</a> to find a CPAN site near you, or see <a href="https://metacpan.org/module/Dist::Zilla::PluginBundle::Author::BBYRD/" class="podlinkurl"
>https://metacpan.org/module/Dist::Zilla::PluginBundle::Author::BBYRD/</a>.</p>

<h1><a class='u'
name="SUPPORT"
>SUPPORT</a></h1>

<h2><a class='u'
name="Internet_Relay_Chat"
>Internet Relay Chat</a></h2>

<p>You can get live help by using IRC ( Internet Relay Chat ). If you don&#39;t know what IRC is, please read this excellent guide: <a href="http://en.wikipedia.org/wiki/Internet_Relay_Chat" class="podlinkurl"
>http://en.wikipedia.org/wiki/Internet_Relay_Chat</a>. Please be courteous and patient when talking to us, as we might be busy or sleeping! You can join those networks/channels and get help:</p>

<ul>
<li>irc.perl.org
<p>You can connect to the server at &#39;irc.perl.org&#39; and join this channel: #distzilla then talk to this person for help: SineSwiper.</p>
</li>
</ul>

<h2><a class='u'
name="Bugs_/_Feature_Requests"
>Bugs / Feature Requests</a></h2>

<p>Please report any bugs or feature requests via <a href="http://search.cpan.org/perldoc?GitHub" class="podlinkpod"
><a href="https://github.com/SineSwiper/Dist-Zilla-PluginBundle-Author-BBYRD/issues" class="podlinkurl"
>https://github.com/SineSwiper/Dist-Zilla-PluginBundle-Author-BBYRD/issues</a></a>.</p>

<h1><a class='u'
name="AUTHOR"
>AUTHOR</a></h1>

<p>Brendan Byrd &#60;BBYRD@CPAN.org&#62;</p>

<h1><a class='u'
name="COPYRIGHT_AND_LICENSE"
>COPYRIGHT AND LICENSE</a></h1>

<p>This software is Copyright (c) 2012 by Brendan Byrd.</p>

<p>This is free software, licensed under:</p>

<pre>  The Artistic License 2.0 (GPL Compatible)</pre>

<!-- end doc -->

</body></html>