Change 12501 by jhi@alpha on 2001/10/19 13:19:14
Subject: [DOC PATCH lib/ExtUtils/MakeMaker.pm] Discouraging use of
PREREQ_FATAL in day-to-day Makefile.PL's
From: Kay R�pke <[EMAIL PROTECTED]>
Date: Fri, 19 Oct 2001 14:04:01 +0200
Message-Id: <[EMAIL PROTECTED]>
Affected files ...
... //depot/perl/lib/ExtUtils/MakeMaker.pm#72 edit
Differences ...
==== //depot/perl/lib/ExtUtils/MakeMaker.pm#72 (text) ====
Index: perl/lib/ExtUtils/MakeMaker.pm
--- perl/lib/ExtUtils/MakeMaker.pm.~1~ Fri Oct 19 07:30:05 2001
+++ perl/lib/ExtUtils/MakeMaker.pm Fri Oct 19 07:30:05 2001
@@ -1781,18 +1781,26 @@
decided at the build time of your perl (unless you override one of
them, of course).
+=item PREREQ_PM
+
+Hashref: Names of modules that need to be available to run this
+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 prequired modules
+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.
-=item PREREQ_PM
+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.
-Hashref: Names of modules that need to be available to run this
-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.
+It is I<extremely> rare to have to use C<PREREQ_FATAL> at all!
=item SKIP
End of Patch.
