NAME

       Module::Install::ExtraTests - contextual tests that the harness can ignore

VERSION

       0.008

COMMANDS

       This plugin adds one Module::Install command:

   extra_tests
         extra_tests;

       This declares that the test files found in the directory ./xt should be run only in
       certain instances:

         ./xt/author  - run when the tests are being run in an author's working copy
         ./xt/smoke   - run when the dist is being smoked (AUTOMATED_TESTING=1)
         ./xt/release - run during "make disttest"

       These directories are recurisvely scanned for *.t files.  If any directories or files
       exist in ./xt that are not recognized, the Makefile.PL will die.

       Achtung!  This is pretty scary, experimental code, mostly because it relies on the pretty
       scary, non-experimental-but-seriously-sketchy underlying customization system for
       ExtUtils::MakeMaker.  I may remove this warning when I've decided that this is stable
       enough, but until then:

         HIC SUNT DRACONES

AUTHOR TESTS

       "Is this being run by an author?" is determined internally by Module::Install, but at the
       time of the writing of this version it's determined by the existence of a directory called
       .author in ./inc.  (On VMS, it's _author.)  This directory is created when
       Module::Install's Makefile.PL is run in a directory where no ./inc directory exists.

BUGS

       Please report any bugs or feature requests through the web interface at
       <http://rt.cpan.org>. I will be notified, and then you'll automatically be notified of
       progress on your bug as I make changes.

COPYRIGHT

       Copyright 2008, Ricardo SIGNES.  This program is free software;  you can redistribute it
       and/or modify it under the same terms as Perl itself.