summaryrefslogtreecommitdiff
path: root/pod/perlhack.pod
diff options
context:
space:
mode:
authorRichard Foley <Richard.Foley@rfi.net>2009-10-01 10:13:52 +0100
committerSteve Hay <SteveHay@planit.com>2009-10-01 10:14:15 +0100
commitc53fdc5e9da36f328ab2620f7ca8c96545281734 (patch)
treea4b5eeff2420efe136357444dc6cf758532e0eca /pod/perlhack.pod
parent4ad470e36742b2d57b7b80113dda4148e1fa10a0 (diff)
downloadperl-c53fdc5e9da36f328ab2620f7ca8c96545281734.tar.gz
Re: lib, ext, cpan and dist [PATCH] (take 2)
Message-Id: <200910011047.35459.Richard.Foley@rfi.net>
Diffstat (limited to 'pod/perlhack.pod')
-rw-r--r--pod/perlhack.pod15
1 files changed, 12 insertions, 3 deletions
diff --git a/pod/perlhack.pod b/pod/perlhack.pod
index 736dd6c777..0164665ae9 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<lib/> and F<ext/>
-subdirectories: F<lib/> is for the pure-Perl modules, and F<ext/>
-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