.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Datum::MakeMaker 3pm"
.TH Datum::MakeMaker 3pm "2022-06-30" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Carp::Datum::MakeMaker \- Offer to strip Carp::Datum calls statically
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 3
\& # Put this at the top of the Makefile.PL for your module
\& use ExtUtils::MakeMaker;       # you may omit this line
\& use Carp::Datum::MakeMaker;
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \f(CW\*(C`Carp::Datum::MakeMaker\*(C'\fR module supersedes the regular \fBWriteMakefile()\fR
routine of \f(CW\*(C`ExtUtils::MakeMaker\*(C'\fR.
.PP
When running the Makefile.PL from a module interactively, the user will
be asked whether calls to \f(CW\*(C`Carp::Datum\*(C'\fR should be stripped at build time.
.PP
By default, or when running non-interactively, most calls to Carp::Datum
routines will be removed:
the \f(CW\*(C`datum_strip\*(C'\fR program will be invoked to filter *.pm files during
the build process.  This program is a mere wrapper for the \fBdatum_strip()\fR
routine, defined in \f(CW\*(C`Carp::Datum::Strip\*(C'\fR.
.PP
The only call that will not be stripped is the \s-1\fBDTRACE\s0()\fR call.  However, it
will be dynamically remapped to a \f(CW\*(C`Log::Agent\*(C'\fR call.  It cannot be statically
remapped because of its baroque interface.
.PP
At the top of Makefile.PL, insert
.PP
.Vb 1
\&    use Carp::Datum::MakeMaker;
.Ve
.PP
which will take care of loading \f(CW\*(C`ExtUtils::MakeMaker\*(C'\fR.  Note that
it makes sense to refer to this module, since \f(CW\*(C`Carp::Datum\*(C'\fR is being used
internally, and therefore the user will not be able to install the module
if they do not have \f(CW\*(C`Carp::Datum\*(C'\fR already installed.
.PP
If you wish to be nicer about \f(CW\*(C`Carp::Datum\*(C'\fR not being installed, you
can say instead:
.PP
.Vb 2
\&    use ExtUtils::MakeMaker;
\&    eval "use Carp::Datum::MakeMaker;";
\&
\&    WriteMakefile(
\&        \*(AqNAME\*(Aq      => "Your::module::name",
\&        \*(AqPREREQ_PM\*(Aq => {
\&            \*(AqCarp::Datum\*(Aq  => \*(Aq0.100\*(Aq,
\&        },
\&    );
.Ve
.PP
It will allow them to run the Makefile.PL, and yet be reminded about the
missing \f(CW\*(C`Carp::Datum\*(C'\fR module.  Chances are they won't be able to go
much farther though...
.SH "AUTHORS"
.IX Header "AUTHORS"
Christophe Dehaudt and Raphael Manfredi are the original authors.
.PP
Send bug reports, hints, tips, suggestions to Dave Hoover at <squirrel@cpan.org>.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBCarp::Datum::Strip\fR\|(3), \fBExtUtils::MakeMaker\fR\|(3).