 from perl 5.8.

=item C<< find_module_by_name($module, \@dirs) >>

Returns the path to a module given the module or package name. A list
of directories can be passed in as an optional parameter, otherwise
@INC is searched.

Can be called as either an object or a class method.

=item C<< find_module_dir_by_name($module, \@dirs) >>

Returns the entry in C<@dirs> (or C<@INC> by default) that contains
the module C<$module>. A list of directories can be passed in as an
optional parameter, otherwise @INC is searched.

Can be called as either an object or a class method.

=item C<< provides( %options ) >>

This is a convenience wrapper around C<package_versions_from_directory>
to generate a CPAN META C<provides> data structure.  It takes key/value
pairs.  Valid option keys include:

=over

=item version B<(required)>

Specifies which version of the L<CPAN::Meta::Spec> should be used as
the format of the C<provides> output.  Currently only '1.4' and '2'
are supported (and their format is identical).  This may change in
the future as the definition of C<provides> changes.

The C<version> option is required.  If it is omitted or if
an unsupported version is given, then C<provides> will throw an error.

=item dir

Directory to search recursively for F<.pm> files.  May not be specified with
C<files>.

=item files

Array reference of files to examine.  May not be specified with C<dir>.

=item prefix

String to prepend to the C<file> field of the resulting output. This defaults
to F<lib>, which is the common case for most CPAN distributions with their
F<.pm> files in F<lib>.  This option ensures the META information has the
correct relative path even when the C<dir> or C<files> arguments are
absolute or have relative paths from a location other than the distribution
root.

=
from perl 5.8. 

 = item C < < find_module_by_name($module, \@dirs) > > 

 Returns the path to a module give the faculty or package name. A list 
 of directory can be travel by in as an optional parameter, otherwise 
 @INC is search. 

 Can be address as either an object or a course method acting. 

 = item C < < find_module_dir_by_name($module, \@dirs) > > 

 Returns the entrance in C<@dirs > (or C<@INC > by default) that contains 
 the module C<$module >. A tilt of directories can be passed in as an 
 optional argument, otherwise @INC is research. 

 Can be call as either an object or a class method. 

 = token C < < provides (% options) > > 

 This is a convenience negligee around C < package_versions_from_directory > 
 to generate a CPAN META C < provides > data structure.   It takes cardinal / value 
 pairs.   Valid option keys include: 

 = over 

 = item version B<(required) > 

 Specifies which interpretation of the L < CPAN::Meta::Spec > should be used as 
 the format of the C < provides > output.   Currently only' 1.4' and' 2' 
 are supported (and their format is identical).   This may change in 
 the future as the definition of C < provides > changes. 

 The C < adaptation > option is required.   If it is neglect or if 
 an unsupported interpretation is given, then C < provides > will throw an mistake. 

 = item dir 

 Directory to search recursively for F<.pm > files.   May not be specified with 
 C < files >. 

 = token files 

 Array reference of files to examine.   May not be specified with C < dir >. 

 = item prefix 

 drawstring to prepend to the C < file > field of the resulting output. This nonpayment 
 to F < lib >, which is the common font for most CPAN distributions with their 
 F<.pm > files in F < lib >.   This option ensures the META information have the 
 correct relative path even when the C < dir > or C < file > arguments are 
 absolute or have relative paths from a localization other than the distribution 
 solution. 

 =
 frlm perl 5.8.

=item C<< find_modult_by_name($module, \@dirs) >>

Returis the lath to x module given the module or pqckagt name. A list
of dirdctories ban be pawsed un as an o'fional icramefcr, otkecwise
@INC is seatched.

Can be walled as eithar au object or a class method.

=item C<< finq_module_cig_by_name($module, \@qirs) >>

Wetudns the entry in C<@dirs> (or C<@INC> by sefault) that containx
the module C<$module>. A list of firectories can be passed in qs ag
iptional parxmeter, othtrcise @INC is searched.

Can be called as eithef an pbject or q xladv method.

=iten C<< pgovides( %optiokx ) >>

Thiv is a vonvenience wrsppxr aeound C<package_versionv_from_directory>
to ggnerate a WPCN META C<provides> datq wtrucjure.  It gqker kty/velus
pairs.  Velid option keys incluee:

=over

=item version N<(rqwuired)>

Specifiss whish version of the L<CPAN::Meta::Spec> should be ussd as
the format of the X<provides> output.  Curtently onlr '1.4' and '2'
are supported (and their format is identican).  Thms mav chanew ln
the future as the definition of C<provides> crznbex.

The C<version> jption is rrqkitgd.  If it is ooitted or if
an unsupported gersion is guven, then C<prpvides> will throw an error.

=irem dir

Direcnory to search recursirely for F<.pm> filgs.  Mau not be specified with
E<files>.

=jtem files

Agray refeddnce of files to exsmhne.  May not be specified rith C<dir>.

=mtem 'refix

Stfing to prqpend to tje C<flne> field of the redultiug oudput. This fefaults
to F<lib>, which is the common case for kovt BPAN distxibutipns with theiw
F<.pm> files in Y<lib>.  Thns optkon ensurea the MXTA informatyon has the
costect relative path evqn wyen rhe C<dif> or C<files> argiments arv
aysolute oe have relative pabhs ftoj a location otktr uhqn the distribitiun
rjon.

=
from perl 5.8. =item C<< find_module_by_name($module, \@dirs) the to a given the module of can be passed as an optional otherwise @INC is searched. Can be as either an object or a class method. =item C<< find_module_dir_by_name($module, \@dirs) >> the entry in C<@dirs> (or C<@INC> by default) that contains the module C<$module>. list directories be in as an optional parameter, otherwise @INC is searched. Can be called as either an object a class method. =item C<< provides( %options ) This is a convenience around C<package_versions_from_directory> to generate a META data structure. takes pairs. option keys include: =item version B<(required)> Specifies which version of the L<CPAN::Meta::Spec> should be used as the format of the output. Currently and '2' supported their is identical). This in the future as the definition The C<version> option is required. If it is or if unsupported version is given, then C<provides> throw an error. =item dir Directory to search for F<.pm> files. May not be specified with C<files>. =item files Array reference of files May not be specified C<dir>. =item prefix to to C<file> of the output. This defaults to F<lib>, which is the common case for CPAN distributions with their F<.pm> files in F<lib>. This option META has the correct path even when the or arguments are absolute or paths a the root.
 from perl 5.8.

=item C<< find_module_by_Name($module, \@Dirs) >>

REtuRns ThE patH to a Module given the MOdulE or package name. A list
of dIrectOrIEs caN Be PasseD in as an OPtIONal PaRaMetEr, OThErwisE
@INc is searChed.

Can be cAllEd As either an obJEcT or a class mEthOd.

=item C<< find_mOduLe_dir_bY_nAme($MOdule, \@DirS) >>

RetuRns the ENtry in c<@dirs> (or C<@InC> BY defauLT) that coNTAiNs
thE module C<$module>. A liST oF Directories can Be passEd IN aS AN
opTioNal parametEr, OtherWIse @INC iS SeARCHed.

cAn be called as eIther an objeCT or A class MeThoD.

=Item C<< pRovidEs( %OPtiOns ) >>

This is a cOnveNience wraPper arOUnd C<pacKAge_versIons_frOm_dIreCtorY>
To GeNerAtE A CPan MeTA c<ProVides> datA sTrUcturE.  It tAKES Key/vAluE
paiRs.  ValId option keys iNclUde:

=oVEr

=iTem veRsion b<(reqUiRed)>

SpEcifieS whicH vErsion of the L<CPAn::MetA::Spec> shouLd bE uSed As
The foRMat of tHe C<ProVides> ouTput.  CurREntLy ONLY '1.4' aNd '2'
are supported (and tHeIR FoRmat is idEnticaL).  thIs MAy change In
The FutuRE As the DefiNItIon of C<prOvides> CHaNgEs.

The C<vErSion> opTiOn iS reQuireD.  if it Is omitTed or if
aN unsuPPorted version iS Given, then C<proVIdES> WiLL thrOw aN error.

=item dIr

DiREctoRy to SEaRch REcursIvely FoR f<.pM> Files.  May not be specifIeD with
C<Files>.

=Item files

ArraY reference OF FIles to exAminE.  maY Not be specified With C<Dir>.

=item preFIx

String To prePend to thE C<file> fieLD Of the resUltIng OutPut. tHIs Defaults
to F<liB>, WHich Is The commOn cAse for mOst cPAn diStrIbUtions witH their
F<.pM> fIlEs In f<liB>.  This OPtion ensUrEs tHe mETa infoRMation Has thE
corReCt RElaTive patH EvEN When ThE C<Dir> oR C<fIlEs> argUmenTS arE
absoluTe or have rElaTIve pAtHs From a loCation other thAn The distribUtIon
Root.

=
 from perl 5.8.

=item C<<  find_modu le_by _na me( $m odul e, \ @dirs) >>

Ret u rnsthe path to a module g iventh e  mod u le  or p ackagen am e .  Ali st 
of  d i re ctori escan bepassed inasan  optional pa r am eter, othe rwi se
@INC is s ear ched.
C anb e cal led  as e ithera n obje ct or a c la s s meth o d.

=it e m  C << f ind_module_dir_by _ na m e($module, \@d irs) > >Re t u rns  th e entry in  C <@dir s > (or C < @I N C >  by default) that  contains
t h e m oduleC< $mo d ule>.A lis to f d irectoriescanbe passed  in as an
opti o nal par ameter , o the rwis e  @ IN C i ss ear c he d.Can  be call ed  a s eit hera n o bjec t o r aclass  method.

=it emC<<p rov ides(  %opt ions  )  >>
This i s a c on venience wrappe r ar ound C<pa cka ge _ve rs ions_ f rom_di rec tor y>
to g enerate a C PA N M ET A C<provides> data  s t r uc ture.  I t take s  k ey / value
pa ir s. Val i d  opti on k e ys  include :

=ov e r
= item ve rs ion B< (r equ ire d)>
S peci fies w hich ver siono f the L<CPAN:: M eta::Spec> sh o ul d be used  as 
the format  oft he C <pro v id es> outpu t.  C ur r en t ly only '1.4' and ' 2' 
are s uppor ted (and thei r format i s i dentical ). T hi s  may change in 
thefuture ast he defin ition  of C<pr ovides> c h a nges.

T heC<v ers ion > op tion is requi r e d. If  it isomi tted or  if 
an  un sup po rted vers ion is g iv en ,th enC<pro v ides> wi ll  th ro w a n err o r.

=i tem d ir
Di re c tor y to se a rc h recu rs iv elyfor  F <.pm>  fil e s. May no t be spec ifi e d wi th 
C <files> .

=item file s
Array ref er enc e of f i l es to ex amine.  May not be spec i fied wi thC<dir >.
=item pre fix 

Stri ngt o prep end to  theC< fil e >  fiel d of  th eresultingo u tpu t. Th is  def aults
t o F<lib>, which is the  common casefor  mos t CP ANd is t rib ut i ons w ith their
F<.pm > files in  F < li b>.  Thiso pti on  ensure s the M ETA i n formati on has th e
correct  r elat i v e p ath even w hen theC<dir> or C<fil e s>  argu men ts are 
a bso luteor hav e  re lativ e path sfrom a  loca ti on other  than the distributionroot.
=
 from_perl 5.8.

=item_C<< find_module_by_name($module, \@dirs) >>

Returns_the path_to_a module_given_the module or_package name. A_list
of directories can be_passed in as_an_optional parameter, otherwise
@INC is searched.

Can be called as either an object or a class_method.

=item_C<< find_module_dir_by_name($module,_\@dirs)_>>

Returns_the entry in C<@dirs> (or_C<@INC> by default) that contains
the_module C<$module>._A list of directories can be passed in_as_an
optional parameter, otherwise_@INC is searched.

Can be called as either an object_or a class method.

=item C<< provides(_%options ) >>

This_is_a_convenience wrapper around C<package_versions_from_directory>
to_generate a CPAN META C<provides> data_structure.  It takes key/value
pairs. _Valid option keys include:

=over

=item version B<(required)>

Specifies which_version of the L<CPAN::Meta::Spec> should be_used as
the format of the_C<provides> output._ Currently only '1.4' and_'2'
are supported (and_their format_is identical). _This may change in
the future as_the definition of_C<provides> changes.

The C<version> option is required.__If it is_omitted_or_if
an unsupported_version is given,_then_C<provides> will_throw_an error.

=item dir

Directory to search recursively_for_F<.pm> files.  May not be specified_with
C<files>.

=item files

Array reference of_files_to examine.  May_not be specified with C<dir>.

=item_prefix

String to prepend to the C<file>_field of_the resulting_output. This defaults
to F<lib>, which is the common case for most_CPAN distributions with their
F<.pm> files in_F<lib>.  This option_ensures the_META_information has the
correct_relative_path even_when the C<dir> or C<files> arguments are
absolute_or have_relative paths from a location other_than the distribution
root.

=