GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
Datum::MakeMaker(3) User Contributed Perl Documentation Datum::MakeMaker(3)

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

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

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...

Christophe Dehaudt and Raphael Manfredi are the original authors.

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

Carp::Datum::Strip(3), ExtUtils::MakeMaker(3).
2002-01-16 perl v5.32.1

Search for    or go to Top of page |  Section 3 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.