From: Richard Foley Date: Thu, 1 Oct 2009 09:13:52 +0000 (+0100) Subject: Re: lib, ext, cpan and dist [PATCH] (take 2) X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=c53fdc5e9da36f328ab2620f7ca8c96545281734;p=p5sagit%2Fp5-mst-13.2.git Re: lib, ext, cpan and dist [PATCH] (take 2) Message-Id: <200910011047.35459.Richard.Foley@rfi.net> --- diff --git a/pod/perlhack.pod b/pod/perlhack.pod index 736dd6c..0164665 100644 --- a/pod/perlhack.pod +++ b/pod/perlhack.pod @@ -365,9 +365,18 @@ correspond to files or directories in the source kit. Among the areas are: =item Core modules -Modules shipped as part of the Perl core live in the F and F -subdirectories: F is for the pure-Perl modules, and F -contains the core XS modules. +Modules shipped as part of the Perl core live in various subdirectories, where +two are dedicated to core-only modules, and two are for the dual-life modules +which live on CPAN and may be maintained separately with respect to the Perl +core: + + lib/ is for pure-Perl modules, which exist in the core only. + + ext/ is for XS extensions, and modules with special Makefile.PL requirements, which exist in the core only. + + cpan/ is for dual-life modules, where the CPAN module is canonical (should be patched first). + + dist/ is for dual-life modules, where the blead source is canonical. =item Tests