NAME
    Module::Install::AggressiveInclude - A more aggressive include
VERSION
    Version 0.01
SYNOPSIS
    At times Module::Install's include() function may not be enough for you.
    In that case Module::Install::AggressiveInclude may be what you need.
    Often for local development I tend to shy away from installing packages
    I may be working on so when working with packages that have multiple
    local dependencies I find my self writing this Makefile.PL code a lot:
        # use lib for my local libraries somewhere around here
        # ...
     
        build_requires 'Module::Find';
        require Module::Find;
     
        include 'FooPackage';
        include $_ foreach Module::Find::findallmod 'FooPackage::*';
     
        # so on and so forth
    Why? You may ask when Module::Install has a support for glob matching of
    packages. Well, because for my (and maybe yours) it is not powerful
    enough when it comes to deep includes.
    For example say we have a lot of modules we want to include from the
    same namespace:
        FooPackage
        FooPackage::Alpha
        FooPackage::Alpha::I
        FooPackage::Alpha::II
        FooPackage::Beta
        FooPackage::Beta::I
        FooPackage::Beta::II
        FooPackage::Gamma
        FooPackage::Gamma::I
        FooPackage::Gamma::II
    If we use Module::Install's include function like this:
        include 'FooPackage::*';
    Only these packages will get included:
        FooPackage::Alpha
        FooPackage::Beta
        FooPackage::Gamma
        # Not even plain ol' FooPackage is included
    In my opinion this lacks some DWIM functionality. So instead we do:
        include_aggressive 'FooPackage';
    And we will get the base package as well as every class under it's
    namespace.
METHODS
  include_aggressive PACKAGE
    Aggressively include PACKAGE and all the modules/packages that fall
    under it
  include_findallmod
    Ties Module::Find::findallmod to Module::Install::include.
  include_findsubmod
    Ties Module::Find::findsubmod to Module::Install::include.
  include_followsymlinks
    Interface with Module::Find::followsymlinks.
  include_ignoresymlinks
    Interface with Module::Find::ignoresymlinks.
AUTHOR
    Jason M Mills, "<jmmills at cpan.org>"
BUGS
    Please report any bugs or feature requests to
    "bug-module-install-aggressiveinclude at rt.cpan.org", or through the
    web interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Module-Install-Aggressiv
    eInclude>. I will be notified, and then you'll automatically be notified
    of progress on your bug as I make changes.
SUPPORT
    You can find documentation for this module with the perldoc command.
        perldoc Module::Install::AggressiveInclude
    You can also look for information at:
    *   RT: CPAN's request tracker
        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=Module-Install-AggressiveI
        nclude>
    *   AnnoCPAN: Annotated CPAN documentation
        <http://annocpan.org/dist/Module-Install-AggressiveInclude>
    *   CPAN Ratings
        <http://cpanratings.perl.org/d/Module-Install-AggressiveInclude>
    *   Search CPAN
        <http://search.cpan.org/dist/Module-Install-AggressiveInclude/>
ACKNOWLEDGEMENTS
LICENSE AND COPYRIGHT
    Copyright 2010 Jason M Mills.
    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.
    See http://dev.perl.org/licenses/ for more information.