view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    Here are all of the different options you can pass to "add_merged":

        $self->add_merged(
           ### SCALARs ###
           # These are all passed to add_plugins with an implicit payload
           'Plugin',
           '@PluginBundle',
           '=Dist::Zilla::Bizarro::Plugin',  # explicit class of plugin
 
           ### ARRAYs ###
           # These are all passed to add_plugins with an explicit payload
           ['Plugin'],
           ['Plugin', 'NewName'],
           ['Plugin', \%new_payload ],
           ['Plugin', 'NewName', \%new_payload ],
 
           ### HASHs ###
           {},              # force no options until reset
           $self->payload,  # reset to original payload
           \%new_payload,   # only pass those arg/value pairs as the payload
 
           $self->config_slice(qw( arg1 arg2 )),                    # only pass those args -from- the payload
           $self->config_slice('arg1', { foobar_arg2 => 'arg2' }),  # only pass those args -from- the payload (with arg renaming)
 
           $self->config_rename(foobar_arg1 => 'arg1'),             # rename args in the payload (and pass everything else)
           $self->config_rename(killme => ''),                      # remove args in the payload (and pass everything else)
 
           ### Combinations ###
           $self->config_short_merge('Plugin', \%add_on_payload),   # add args to the payload, pass to Plugin, and reset to original
           $self->config_short_merge(
              [ qw( Plugin1 Plugin2 ) ],    # add args to the payload, pass to plugin list, and reset to original payload
              \%add_on_payload
           ),
        );

CAVEATS
    *   Plugins that use non-standard payload methods will not be passed
        their options via "add_merged", unless passed an arrayref to
        "add_merged" with an specific payload. The "config_merge" method
        will warn you of this, because it knows that you really want to use
        that argument. Others will not.

    *   Doing things more implicitly grants greater flexibility while
        sacrificing control. YMMV.

AVAILABILITY
    The project homepage is
    <https://github.com/SineSwiper/Dist-Zilla-Role-PluginBundle-Merged/wiki>
    .

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

SUPPORT
  Internet Relay Chat
    You can get live help by using IRC ( Internet Relay Chat ). If you don't
    know what IRC is, please read this excellent guide:
    <http://en.wikipedia.org/wiki/Internet_Relay_Chat>. 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:

    *   irc.perl.org

        You can connect to the server at 'irc.perl.org' and talk to this
        person for help: SineSwiper.

  Bugs / Feature Requests
    Please report any bugs or feature requests via
    <https://github.com/SineSwiper/Dist-Zilla-Role-PluginBundle-Merged/issue
    s>.

AUTHOR
    Brendan Byrd <bbyrd@cpan.org>

COPYRIGHT AND LICENSE
    This software is Copyright (c) 2013 by Brendan Byrd.

    This is free software, licensed under:

      The Artistic License 2.0 (GPL Compatible)