NAME

       Carp::Datum::MakeMaker - Offer to strip Carp::Datum calls statically

SYNOPSIS

        # Put this at the top of the Makefile.PL for your module
        use ExtUtils::MakeMaker;       # you may omit this line
        use Carp::Datum::MakeMaker;

DESCRIPTION

       The "Carp::Datum::MakeMaker" module supersedes the regular WriteMakefile() routine of
       "ExtUtils::MakeMaker".

       When running the Makefile.PL from a module interactively, the user will be asked whether
       calls to "Carp::Datum" should be stripped at build time.

       By default, or when running non-interactively, most calls to Carp::Datum routines will be
       removed: the "datum_strip" program will be invoked to filter *.pm files during the build
       process.  This program is a mere wrapper for the datum_strip() routine, defined in
       "Carp::Datum::Strip".

       The only call that will not be stripped is the DTRACE() call.  However, it will be
       dynamically remapped to a "Log::Agent" call.  It cannot be statically remapped because of
       its baroque interface.

       At the top of Makefile.PL, insert

           use Carp::Datum::MakeMaker;

       which will take care of loading "ExtUtils::MakeMaker".  Note that it makes sense to refer
       to this module, since "Carp::Datum" is being used internally, and therefore the user will
       not be able to install the module if they do not have "Carp::Datum" already installed.

       If you wish to be nicer about "Carp::Datum" not being installed, you can say instead:

           use ExtUtils::MakeMaker;
           eval "use Carp::Datum::MakeMaker;";

           WriteMakefile(
               'NAME'      => "Your::module::name",
               'PREREQ_PM' => {
                   'Carp::Datum'  => '0.100',
               },
           );

       It will allow them to run the Makefile.PL, and yet be reminded about the missing
       "Carp::Datum" module.  Chances are they won't be able to go much farther though...

AUTHORS

       Christophe Dehaudt and Raphael Manfredi are the original authors.

       Send bug reports, hints, tips, suggestions to Dave Hoover at <squirrel@cpan.org>.

SEE ALSO

       Carp::Datum::Strip(3), ExtUtils::MakeMaker(3).