Author: kwilliams
Date: Mon Jan 22 05:23:07 2007
New Revision: 8674
Modified:
Module-Build/trunk/Changes
Module-Build/trunk/lib/Module/Build/API.pod
Log:
Add docs for _build/prereqs
Modified: Module-Build/trunk/Changes
==============================================================================
--- Module-Build/trunk/Changes (original)
+++ Module-Build/trunk/Changes Mon Jan 22 05:23:07 2007
@@ -1,5 +1,8 @@
Revision history for Perl extension Module::Build.
+ - Added some verbiage in Module::Build::API that officially blesses
+ the _build/prereqs file for external consumption. [Suggested by Andreas
Koenig]
+
- Added test profiles support via the test_types property and "testall"
target. [Eric Wilhelm, Jeff Lavallee]
Modified: Module-Build/trunk/lib/Module/Build/API.pod
==============================================================================
--- Module-Build/trunk/lib/Module/Build/API.pod (original)
+++ Module-Build/trunk/lib/Module/Build/API.pod Mon Jan 22 05:23:07 2007
@@ -1013,6 +1013,15 @@
data in a directory called C<_build/>. Both of these will be removed
when the C<realclean> action is performed.
+Among the files created in C<_build/> is a F<_build/prereqs> file
+containing the set of prerequisites for this distribution, as a hash
+of hashes. This file may be C<eval()>-ed to obtain the authoritative
+set of prereqs, which might be different from the contents of META.yml
+(because F<Build.PL> might have set them dynamically). But fancy
+developers take heed: do not put any fancy custom code in the
+F<_build/prereqs> file, leave it as a static declaration containing
+only strings and numbers. Please.
+
=item current_action()
[version 0.28]
