summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Mitchell <davem@iabyn.com>2009-06-19 15:57:27 +0100
committerDavid Mitchell <davem@iabyn.com>2009-06-19 15:57:27 +0100
commit2c95b6e4c4a0372d018a26686c0b0af74cf6592c (patch)
treeced0ca18027e03b2d8f167e36a97b3bb0e856338
parent458b44e7bc48569051e0eb9b5630ba87d7e5eed4 (diff)
downloadperl-2c95b6e4c4a0372d018a26686c0b0af74cf6592c.tar.gz
Maintainers.pl: add @IGNORABLE and document EXCLUDED, MAP fields
-rw-r--r--Porting/Maintainers.pl46
1 files changed, 46 insertions, 0 deletions
diff --git a/Porting/Maintainers.pl b/Porting/Maintainers.pl
index f3bc86cb3b..cc6f4c067c 100644
--- a/Porting/Maintainers.pl
+++ b/Porting/Maintainers.pl
@@ -88,6 +88,21 @@ package Maintainers;
'zefram' => 'Andrew Main <zefram@cpan.org>',
);
+
+# IGNORABLE: files which, if they appear in the root of a CPAN
+# distribution, need not appear in core (i.e. core-cpan-diff won't
+# complain if it can't find them)
+
+@IGNORABLE = qw(
+ .cvsignore .dualLivedDiffConfig .gitignore
+ ANNOUNCE Announce Artistic AUTHORS BENCHMARK BUGS Build.PL
+ CHANGELOG ChangeLog CHANGES Changes COPYING Copying CREDITS
+ GOALS HISTORY INSTALL INSTALL.SKIP LICENSE Makefile.PL
+ MANIFEST MANIFEST.SKIP META.yml NEW NOTES ppport.h README
+ SIGNATURE THANKS TODO Todo VERSION WHATSNEW
+);
+
+
# Each entry in the %Modules hash roughly represents a distribution,
# except in the case of CPAN=1, where it *exactly* represents a single
# CPAN distribution.
@@ -119,6 +134,37 @@ package Maintainers;
# included in core are derived from. Note that the file's version may not
# necessarily match the newest version on CPAN.
+# EXCLUDED is a list of files to be excluded from a CPAN tarball before
+# comparing the remaining contents with core. Each item can either be a
+# full pathname (eg 't/foo.t') or a pattern (e.g. qr{^t/}).
+# It defaults to the empty list.
+
+# MAP is a hash that maps CPAN paths to their core equivalents.
+# Each key reprepresents a string prefix, with longest prefixes checked
+# first. The first match causes that prefix to be replaced with the
+# corresponding key. For example, with the following MAP:
+# {
+# 'lib/' => 'lib/',
+# '' => 'lib/Foo/',
+# },
+#
+# these files are mapped as shown:
+#
+# README becomes lib/Foo/README
+# lib/Foo.pm becomes lib/Foo.pm
+#
+# The default is dependent on the type of module.
+# For distributions which appear to be stored under ext/, it defaults to:
+#
+# { '' => 'ext/Foo-Bar/' }
+#
+# otherwise, it's
+#
+# {
+# 'lib/' => 'lib/',
+# '' => 'lib/Foo/Bar/',
+# }
+
%Modules = (
'Archive::Extract' =>