summaryrefslogtreecommitdiff
path: root/lib/ExtUtils
diff options
context:
space:
mode:
authorKay Röpke <kroepke@dolphin-services.de>2001-10-19 16:04:01 +0200
committerJarkko Hietaniemi <jhi@iki.fi>2001-10-19 13:19:14 +0000
commitb2340c5389c063ab29f77699c0b379e3bea4fa31 (patch)
treeba764211e38a5c33c3d18024082647e410784156 /lib/ExtUtils
parent71d929cb3e130a6486f59d4312ce76d7d6eea647 (diff)
downloadperl-b2340c5389c063ab29f77699c0b379e3bea4fa31.tar.gz
[DOC PATCH lib/ExtUtils/MakeMaker.pm] Discouraging use of PREREQ_FATAL in day-to-day Makefile.PL's
Message-Id: <E15uYNb-00040L-00@mrvdom01.schlund.de> p4raw-id: //depot/perl@12501
Diffstat (limited to 'lib/ExtUtils')
-rw-r--r--lib/ExtUtils/MakeMaker.pm20
1 files changed, 14 insertions, 6 deletions
diff --git a/lib/ExtUtils/MakeMaker.pm b/lib/ExtUtils/MakeMaker.pm
index 0f46a4fcf8..ef8bfab2dc 100644
--- a/lib/ExtUtils/MakeMaker.pm
+++ b/lib/ExtUtils/MakeMaker.pm
@@ -1781,12 +1781,6 @@ branch from that node into lib/, lib/ARCHNAME or whatever Configure
decided at the build time of your perl (unless you override one of
them, of course).
-=item PREREQ_FATAL
-
-Bool. If this parameter is true, failing to have the prequired modules
-(or the right versions thereof) will be fatal. perl Makefile.PL will die
-with the proper message.
-
=item PREREQ_PM
Hashref: Names of modules that need to be available to run this
@@ -1794,6 +1788,20 @@ extension (e.g. Fcntl for SDBM_File) are the keys of the hash and the
desired version is the value. If the required version number is 0, we
only check if any version is installed already.
+=item PREREQ_FATAL
+
+Bool. If this parameter is true, failing to have the required modules
+(or the right versions thereof) will be fatal. perl Makefile.PL will die
+with the proper message.
+
+Note: see L<Test::Harness> for a shortcut for stopping tests early if
+you are missing dependencies.
+
+Do I<not> use this parameter for simple requirements, which could be resolved
+at a later time, e.g. after an unsuccessful B<make test> of your module.
+
+It is I<extremely> rare to have to use C<PREREQ_FATAL> at all!
+
=item SKIP
Arrayref. E.g. [qw(name1 name2)] skip (do not write) sections of the