.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" 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 "ExtUtils::MakeMaker::CPANfile 3pm"
.TH ExtUtils::MakeMaker::CPANfile 3pm "2019-01-05" "perl v5.28.1" "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"
ExtUtils::MakeMaker::CPANfile \- cpanfile support for EUMM
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 2
\&    # Makefile.PL
\&    use ExtUtils::MakeMaker::CPANfile;
\&    
\&    WriteMakefile(
\&      NAME => \*(AqFoo::Bar\*(Aq,
\&      AUTHOR => \*(AqA.U.Thor <author@cpan.org>\*(Aq,
\&    );
\&    
\&    # cpanfile
\&    requires \*(AqExtUtils::MakeMaker\*(Aq => \*(Aq6.17\*(Aq;
\&    on test => sub {
\&      requires \*(AqTest::More\*(Aq => \*(Aq0.88\*(Aq;
\&    };
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
ExtUtils::MakeMaker::CPANfile loads \f(CW\*(C`cpanfile\*(C'\fR in your distribution
and modifies parameters for \f(CW\*(C`WriteMakefile\*(C'\fR in your Makefile.PL.
Just use it instead of ExtUtils::MakeMaker (which should be
loaded internally), and prepare \f(CW\*(C`cpanfile\*(C'\fR.
.PP
As of version 0.03, ExtUtils::MakeMaker::CPANfile also removes
WriteMakefile parameters that the installed version of
ExtUtils::MakeMaker doesn't know, to avoid warnings.
.SH "LIMITATION"
.IX Header "LIMITATION"
.SS "complex version ranges"
.IX Subsection "complex version ranges"
As of this writing, complex version ranges are simply ignored.
.SS "dynamic config"
.IX Subsection "dynamic config"
Strictly speaking, \f(CW\*(C`cpanfile\*(C'\fR is a Perl script, and may have some
conditions in it. That said, you don't need to run Makefile.PL
to determine prerequisites in most cases. Hence, as of 0.06,
ExtUtils::MakeMaker::CPANfile sets \f(CW\*(C`dynamic_config\*(C'\fR to false
by default. If you do need a \s-1CPAN\s0 installer to run Makefile.PL
to customize prerequisites dynamically, set \f(CW\*(C`dynamic_config\*(C'\fR
to true explicitly (via \s-1META_ADD/META_MERGE\s0).
.SH "FOR MODULE AUTHORS"
.IX Header "FOR MODULE AUTHORS"
Though the minimum version requirement of ExtUtils::MakeMaker is
arbitrary set to 6.17 (the one bundled in Perl 5.8.1), you need
at least \s-1EUMM 6.52\s0 (with \s-1CONFIGURE_REQUIRES\s0 support) when you
release a distribution.
.SH "LICENSE"
.IX Header "LICENSE"
Copyright (C) Kenichi Ishigaki.
.PP
This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.
.SH "AUTHOR"
.IX Header "AUTHOR"
Kenichi Ishigaki <ishigaki@cpan.org>