doc f7abe7
[p5sagit/p5-mst-13.2.git] / cpan / Module-Build / Changes
1 Revision history for Perl extension Module::Build.
2
3 0.3603 - Mon Jan 18 22:28:59 EST 2010
4
5 (Oops, I released the last one before I realized this should have been
6 fixed along with it.)
7
8  Bug fixes:
9
10  - Module::Build::Compat would croak on distibutions that set requires
11    'perl' to a dotted decimal like '5.6.2'.  We now skip that key
12    since it doesn't go into PREREQ_PM and we numify it properly for
13    'use 5.006002' in the generated Makefile.PL (RT#53409)
14    [David Golden, adapted from patch by G. Allen Morris III]
15
16 0.3602 - Mon Jan 18 22:09:54 EST 2010
17
18  Bug fixes:
19
20  - Fix failures in t/properties/needs_compiler.t when $ENV{CC} is set
21    (RT#53296) [David Golden, adapted from patch by Jens Rehsack]
22
23 0.3601 - Mon Dec 21 14:39:33 EST 2009
24
25  Bug fixes:
26
27  - When the currently running Module::Build is not the same as the one
28    that created the Build file, there is now a warning rather than a fatal
29    error.  This helps installation of dependency chains where a dependency
30    might configure_requires a new Module::Build after Build.PL was already
31    run for an earlier distribution. [David Golden, on advice of Matt Trout]
32
33  Other:
34
35  - t/bundle_inc.t fails in odd ways.  This test of an experimental feature
36    should not prevent users from installing Module::Build, so this test
37    now skips unless $ENV{MB_TEST_EXPERIMENTAL} is true
38
39 0.36 - Sun Dec 20 15:02:38 EST 2009
40
41 No changes from 0.35_15 other than the version number.
42
43 Summary of major changes since 0.35:
44
45  Enhancements:
46
47  - Added 'Build installdeps' action to install needed dependencies via
48    a user-configurable command line program.  (Defaults to 'cpan'.)
49
50  - Command line options may be set via the PERL_MB_OPT environment
51    variable (similar to PERL_MM_OPT in ExtUtils::MakeMaker)
52
53  - Generates MYMETA.yml during Build.PL (new standard protocol for
54    communicating configuration results between toolchain components)
55
56  - Reduced amount of console output under normal operation (use --verbose
57    to see all output)
58
59  - Added experimental inc/ bundling; see Module::Build::Bundling for
60    details.
61
62  New or changed properties:
63
64  - Added 'share_dir' property to provide File::ShareDir support;
65    File::ShareDir automatically added to 'requires' if 'share_dir' is set
66
67  - Added 'needs_compiler' property.  Defaults to true if XS or c_source
68    exist.  If true, ExtUtils::CBuilder is also added to build_requires.
69
70  - 'C_support' is no longer an optional feature.  Modern ExtUtils::CBuilder
71    and ExtUtils::ParseXS added to the 'requires' list.  This ensures that
72    upgrading Module::Build will upgrade these critical modules.
73
74  - Clarified that 'apache' in the license attribute indicates the Apache
75    License 2.0 and added 'apache_1_1' for the older version of the license
76    (RT#50614)
77
78  Deprecations:
79
80  - Module::Build::Compat 'passthrough' style has been deprecated.  Using
81    'passthrough' will issue warnings on Makefile.PL generation.  See
82    Module::Build::Compat documentation for rationale.
83
84  Internals:
85
86  - Replaced use of YAML.pm with YAML::Tiny; Module::Build::YAML is now
87    based on YAML::Tiny as well
88
89  - A new get_metadata() method has been added as a simpler wrapper around
90    the old, kludgy prepare_metadata() API.
91
92  - Replaced guts of new_from_context().  Build.PL is now executed in a
93    separate process before resume() is called.  (This is generally only of
94    interest to Module::Build or toolchain developers) (RT#49350)
95
96  - Add support for 'package NAME VERSION' syntax added in Perl 5.11.1
97
98  Notable bug fixes:
99
100  - The "test" action now dies when using the 'use_tap_harness'
101    option and tests fail, matching the behavior under Test::Harness.
102    (RT#49080) [initial patch from David Wheeler; revised by David Golden]
103
104  - Updated PPM generation to PPM v4 (RT#49600) [Olivier Mengue]
105
106  - When module_name is not supplied, no packlist was being written; fixed
107    by guessing module_name from dist_version_from or the directory name
108    (just like ExtUtils::Manifest does without NAME) [David Golden]
109
110  - Failure to detect a compiler will now warn during Build.PL and be a
111    fatal error when trying to compile during Build. (RT#48918) [David
112    Golden]
113
114  - Auto-detection of abstract and author fixed for mixed-case POD headers
115    (RT#51117) [David Wheeler]
116
117  - resume() was not restoring additions to @INC added in Build.PL
118    (RT#50145) [David Golden]
119
120  - When tarball paths are less than 100 characters, disables 'prefix'
121    mode of Archive::Tar for maximum compatibility (RT#50571) [David Golden]
122
123  - Merging 'requires' and 'build_requires' in Module::Build::Compat could
124    lead to duplicate PREREQ_PM entries; now the highest version is used
125    for PREREQ_PM. (RT#50948) [David Golden]
126
127  - Module::Build::Compat will now die with an error if advanced,
128    non-numeric prerequisites are given, as these are not supported by
129    ExtUtils::MakeMaker in PREREQ_PM [David Golden]
130
131
132 0.35_15 - Thu Dec 17 17:51:22 EST 2009
133
134  Bug fixes:
135
136  - Make sure PPM tests are skipped if IO::File is too old [David Golden]
137
138 0.35_14 - Thu Dec 17 16:02:14 EST 2009
139
140  Bug fixes:
141
142  - If not set, the 'module_name' is detected from 'dist_version_from'
143    or from 'dist_name'.  The directory is no longer used. [David Golden]
144
145  - The 'share_dir' property no longer defaults to 'share' and must be
146    explicitly set instead; this fixes problems for CPAN distributions that
147    already have a 'share' directory for whatever reason [David Golden]
148
149  - Change t/00-compile.t test for more portability [David Golden]
150
151  - Skip ppm.t if Pod::Html is not available [David Goldenj]
152
153  - Changed guts of inc::latest to work properly on older versions of Perl
154    [David Golden]
155
156  - Ensure bundle_inc.t doesn't accidentally uninstall the installed M::B
157    during testing if the user had 'uninst=1' set during Build.PL
158    [David Golden]
159
160 0.35_13 - Sat Dec  5 11:26:36 EST 2009
161
162  Bug fixes:
163
164  - Protect against tempfile errors when checking ExtUtils::Installed
165    [David Golden]
166
167 0.35_12 - Fri Dec  4 23:06:49 EST 2009
168
169  Bug fixes:
170
171  - Protect inc/ bundling tests against broken ExtUtils::Installed
172    [David Golden]
173
174 0.35_11 - Thu Dec  3 11:07:44 EST 2009
175
176  *** API CHANGE ***
177
178  - The old API for prepare_metadata() has been restored to avoid breaking
179    distributions that were overriding it (e.g. BioPerl), but the method
180    has been marked deprecated and may be made private or may disappear in
181    some future version of Module::Build. [David Golden]
182
183  - A new get_metadata() method has been added as a simpler wrapper around
184    the old, kludgy prepare_metadata() API. [David Golden]
185
186 0.35_10 - Tue Nov 24 22:49:19 EST 2009
187
188  Bug fixes:
189
190  - bundle_inc.t is more careful about permissions and open filehandles
191    to avoid failures/skips on Win32 [David Golden]
192
193  - Fix compilation error in Module::Build::Platform::VMS (RT#51766)
194    [David Golden]
195
196  - Don't generate a MANIFEST.SKIP during distclean and add any generated
197    MANIFEST.SKIP to cleanup list [reported by Zefram, fixed by David Golden]
198
199  - Module::Build::ModuleInfo version parsing would fail if a module sets
200    its $VERSION from another module, but the other module is not installed.
201    We now try to detect such failures, prepend 'lib' to @INC and try again.
202    [David Golden]
203
204  - MYMETA.yml used to be generated from scratch, overriding any
205    customizations used to create META.yml.  Now, if META.yml exists, that
206    will be used as the base for MYMETA and only prereq fields will be
207    updated (to reflect any dynamic configuration); also, 'dynamic_config'
208    will be set to false and 'generated_by' will be updated [David Golden]
209
210 0.35_09 - Thu Nov 19 01:30:42 EST 2009
211
212  Bug fixes:
213
214  - The DB package should not be included in 'provides' in META files
215    [David Golden]
216
217  - Fixed t/xs.t build failures in bleadperl for noexec temp directories
218    [Nicholas Clark]
219
220  - Adjusted order of @INC in resume() (fixes par.t, ppm.t, xs.t fails):
221    @INC = @new_additions_to_inc, @saved_additions_to_inc, @default_inc
222    [David Golden]
223
224  - Skip bundle_inc.t tests if bundled Module::Build for test can't be
225    tweaked (Works around test crashes on Win2) [David Golden]
226
227  Other:
228
229  - 'C_support' is no longer an optional feature.  Modern ExtUtils::CBuilder
230    and ExtUtils::ParseXS added to the 'requires' list.  This ensures that
231    upgrading Module::Build will upgrade this critical modules.
232    ExtUtils::CBuilder no longer requires a compiler, so it is "safe" to
233    require.
234
235 0.35_08 - Mon Nov 16 22:38:28 EST 2009
236
237  Bug fixes:
238
239  - Multiple tests were failing due to dependency problems.  Author
240    dependencies have been largely removed from core 'requires' into
241    optional features.  Feature prereq detection and messaging have been
242    expanded and bugs on older Perls have been removed.
243
244 0.35_07 - Sat Nov 14 17:14:39 EST 2009
245
246  Bug fixes:
247
248  - Auto-detection of abstract and author fixed for mixed-case POD headers
249    (RT#51117) [David Wheeler]
250
251  - resume() was not restoring additions to @INC added in Build.PL
252    (RT#50145) [David Golden]
253
254  - When tarball paths are less than 100 characters, disables 'prefix'
255    mode of Archive::Tar for maximum compatibility (RT#50571) [David Golden]
256
257 0.35_06 - Fri Nov 13 14:51:28 EST 2009
258
259  Enhancements:
260
261  - Added experimental inc/ bundling; see Module::Build::Bundling for
262    details.  [David Golden and Eric Wilhelm]
263
264  - Clarified that 'apache' in the license attribute indicates the Apache
265    License 2.0 and added 'apache_1_1' for the older version of the license
266    (RT#50614) [David Golden]
267
268  Bug fixes:
269
270  - Merging 'requires' and 'build_requires' in Module::Build::Compat could
271    lead to duplicate PREREQ_PM entries; now the highest version is used
272    for PREREQ_PM. (RT#50948) [David Golden]
273
274  - Module::Build::Compat will now die with an error if advanced,
275    non-numeric prerequisites are given, as these are not supported by
276    ExtUtils::MakeMaker in PREREQ_PM [David Golden]
277
278  - Made MYMETA generation non-fatal if fields required for META.yml
279    are missing [David Golden]
280
281  - Added Pod::Simple to requirements for manpage support; avoids
282    problems if a user has a broken Pod::Man/Pod::Simple.  (RT#50081)
283    [David Golden]
284
285  - Won't die if installed Pod::Readme is broken [David Golden]
286
287  Other:
288
289  - Fixed Module::Build::Notes POD [David Golden]
290
291  - Some commands had become silent by default, so added a few short status
292    messages so users know something actually happened [David Golden]
293
294  - Cleaned up Changes file formatting [David Golden]
295
296  - Removed most PERL_CORE customizations from test files due to
297    reorganization of dual-life modules in core (RT#49522) [David Golden]
298
299 0.35_05 - Wed Oct 28 17:20:59 EDT 2009
300
301  Bug fixes:
302
303  - Fix test failure in t/actions/installdeps.t when $^X is not the default
304    perl [David Golden]
305
306  - Work around $VERSION numbers in ActiveState with multiple underscores
307    that prevent Module::Build from installing on Win32 [David Golden]
308
309  - Fix bug cleaning compatibility Makefile when older ExtUtils::Manifest is
310    installed [David Golden with help from David Cantrell]
311
312  Other:
313
314  - Suppressed more warnings from tests [David Golden]
315
316  - Add provisional support for 'package NAME VERSION' syntax added in
317    Perl 5.11.1 [David Golden]
318
319 0.35_04 - Fri Oct 23 11:20:41 EDT 2009
320
321  Bug fixes:
322
323  - Fix test failure if IPC::Cmd isn't installed [David Golden]
324
325  Other:
326
327  - Suppressed warning messages from various tests [David Golden]
328
329 0.35_03 - Wed Oct 21 21:20:59 EDT 2009
330
331  *** API CHANGE ***
332
333  - The prepare_metadata() method used to take a YAML::Node object as an
334    argument for modification.  The method now takes no arguments and just
335    returns a hash reference of metadata. [David Golden]
336
337  Enhancements
338
339  - Command line options may be set via the PERL_MB_OPT environment
340    variable (similar to PERL_MM_OPT in ExtUtils::MakeMaker)
341
342  Bug fixes:
343
344  - Updated PPM generation to PPM v4 (RT#49600) [Olivier Mengue]
345
346  - When c_source is specified, the directory scan will include additional,
347    less-common C++ extensions (RT49298) [David Golden]
348
349  - When module_name is not supplied, no packlist was being written; fixed
350    by guessing module_name from dist_version_from or the directory name
351    (just like ExtUtils::Manifest does without NAME) [David Golden]
352
353  - Bumped IO::File prereq to fix binmode failures in PPMMaker on Perl
354    prior to 5.8.8 [David Golden]
355
356  Other:
357
358  - Replaced use of YAML.pm with YAML::Tiny; Module::Build::YAML is now
359    based on YAML::Tiny as well [David Golden]
360
361  - Reduced amount of console output under normal operation (use --verbose
362    to see all output) [David Golden]
363
364 0.35_02 - Mon Sep  7 22:37:42 EDT 2009
365
366  Enhancements:
367
368  - Added 'needs_compiler' property.  Defaults to true if XS or c_source
369    exist.  If true, ExtUtils::CBuilder is also added to build_requires.
370    [David Golden]
371
372  - File::ShareDir automatically added to 'requires' if 'share_dir' is set
373    [David Golden]
374
375  - Added 'Build installdeps' action to install needed dependencies via
376    a user-configurable command line program.  (Defaults to 'cpan'.)
377    [Eric Wilhelm]
378
379  Bug fixes:
380
381  - Failure to detect a compiler will now warn during Build.PL and be a
382    fatal error when trying to compile during Build. (RT#48918) [David
383    Golden]
384
385  - Fixed directory sorting failure in share_dir.t [David Golden]
386
387  - Property defaults that are data structures were being assigned as
388    references to new objects. Changed so that defaults are cloned instead.
389    (This mostly affects testing, which often creates multiple objects in the
390    same process) [David Golden]
391
392  - Simplified error message on exit under use_tap_harness [suggested by
393    David Wheeler]
394
395  - Fixed typemap search to use a dist-level typemap if a typemap is not
396    found in the directory with the *.xs file; (was manifesting as warnings
397    in Perl 5.6 tests) [David Golden]
398
399  Other:
400
401  - Replaced guts of new_from_context().  Build.PL is now executed in a
402    separate process before resume() is called.  (This is generally only of
403    interest to Module::Build or toolchain developers) (RT#49350) [David
404    Golden, Eric Wilhelm, Ken Williams]
405
406  - Revised test helper classes to fix potential bugs and add new features
407    to make writing tests simpler and easier.  Changes incorporated into
408    t/README.pod and t/sample.t as examples for new testing. [David Golden]
409
410 0.35_01 - Mon Aug 31 12:11:10 EDT 2009
411
412  Enhancements:
413
414  - Generates MYMETA.yml during Build.PL (new standard protocol for
415    communicating configuration results between toolchain components)
416    [David Golden]
417
418  - Added 'share_dir' property to provide File::ShareDir support;
419    set automatically if a directory called 'share' exists
420    [David Golden]
421
422  Bug fixes:
423
424  - Fix the t/destinations.t fix. [David Golden, with thanks to Eric Wilhelm]
425
426  - Fix recursive test files in generated Makefile.PL (RT#49254) [Sawyer X]
427
428  - Guard against trying :utf8 when :utf8 isn't available
429
430  - The "test" action now dies when using the 'use_tap_harness'
431    option and tests fail, matching the behavior under Test::Harness.
432    (RT#49080) [initial patch from David Wheeler; revised by David Golden]
433
434  Other:
435
436  - Added t/README.pod and t/sample.t to guide developers writing new tests
437    [David Golden, with some code from Eric Wilhelm]
438
439  - Module::Build::Compat 'passthrough' style has been deprecated.  Using
440    'passthrough' will issue warnings on Makefile.PL generation.  See
441    Module::Build::Compat documentation for rationale.
442
443 0.35 - Thu Aug 27 09:12:02 EDT 2009
444
445  Bug fixes:
446
447   - Fix t/destinations.t segfault on 5.6.2 [David Golden]
448
449 0.34_06 - Sat Aug 22 21:58:26 EDT 2009
450
451  Bug fixes:
452
453  - Multiple test fixes for OS2 [Ilya Zakharevich]
454
455  - Generated.ppd files use :utf8 if possible (RT#48827) [Olivier Mengue]
456
457  - Fixed preservation of custom install_paths on resume (RT#41166)
458    [David Golden]
459
460  - Warn instead of crashing when Pod::Man tries to create files with
461    colons on vfat partitions on unix (RT#45544) [David Golden]
462
463 0.34_05 - Sun Aug  9 22:31:37 EDT 2009
464
465  Bug fixes:
466
467  - When auto_configure_requires is true (the default), Module::Build will
468    only add last 'major' version of Module:Build (e.g. 0.XX) to
469    configure_requires to avoid specifying a minor development release not
470    available on CPAN [David Golden]
471
472 0.34_04 - Sat Aug  8 11:02:24 EDT 2009
473
474  Other:
475
476  - Added documentation warning that 'get_options' should be capitalized
477    to avoid conflicting with future Module::Build options and changed
478    the examples accordingly.
479
480 0.34_03 - Sat Aug  8 07:39:16 EDT 2009
481
482  Bug fixes:
483
484  - Fixed failing xs.t if /tmp is mounted noexec (RT#47331) [David Golden]
485
486  - Fixed failing debug.t on VMS (RT#48362) [Craig Berry]
487
488  - Prevent par.t from dying on error in .zip extraction [David Golden]
489
490  - Fixed potential runthrough.t failure on 5.6.2 [David Golden]
491
492  Other:
493
494  - Archive::Tar changed from 'requires' to 'recommends' so non-authors
495    without IO::Zlib can still use Module::Build to install modules
496    [reported by Matt Trout, fix by David Golden]
497
498 0.340201 - Sun Aug  9 22:11:04 EDT 2009
499
500  Other:
501
502  - Version bump for Perl core for 5.10.1 release; no other changes
503
504 0.34_02 - Sun Jul 26 22:50:40 EDT 2009
505
506  Bug-fixes:
507
508  - Bundled Module::Build::Version updated to bring into sync with CPAN
509    version.pm 0.77 [John Peacock]
510
511 0.34_01 - Sat Jul 18 16:32:09 EDT 2009
512
513  Enhancements:
514
515  - Added --debug flag to trace Build action execution (RT#47933)
516    [David Golden]
517
518  Bug-fixes:
519
520  - Bundled Module::Build::Version version code updated to fix unsafe use
521    of $@ (RT#47980) [John Peacock]
522
523 0.34 - Tue Jul  7 16:56:47 EDT 2009
524
525  No changes from 0.33_06
526
527 0.33_06 - Sun Jul  5 10:11:40 EDT 2009
528
529  Bug-fixes:
530
531  - Bundled version code will use pure Perl on 5.10.0 to work around
532    a corner case involving eval and locale [John Peacock]
533
534  - Reversed VMS patch from 0.33_03 [Craig Berry]
535
536  - PL_files in Build.PL that are in the bin/scripts directory should not be
537    installed as if they are scripts (fixed for case-tolerant systems).
538    [David Golden, reported by Craig Berry]
539
540 0.33_05 - Sun Jun 28 22:06:49 EDT 2009
541
542  Enhancements:
543
544  - New 'auto_configure_requires' parameter (default 1) controls
545    whether Module::Build should add itself to configure_requires
546    in META.yml if not specified in Build.PL [David Golden]
547
548  Bug-fixes:
549
550  - The default MANIFEST.SKIP created by the "manifest" action
551    was out of date.  It will now use the installed MANIFEST.SKIP
552    and add some Module::Build and distribution specific items
553    to it. [Michael Schwern]
554
555  Other:
556
557  - configure_requires do not necessarily need to be in requires
558    or build_requires; warning to that effect has been removed
559    [David Golden]
560
561 0.33_04 - Fri Jun 26 07:09:06 EDT 2009
562
563  Bug-fixes:
564
565  - Don't try utf8 YAML I/O on Perl 5.6 [David Golden]
566
567  Other:
568
569  - configure_requires added to prereq report (RT#47254) [Curtis Jewell]
570
571  - updated Module::Build::Version to match forthcoming version.pm 0.77
572    (RT#47256) [John Peacock]
573
574  - skips xs.t and ppm.t when perl was not compiled with dynamic loading
575    since Module::Buld does not support static linking (RT#46178)
576    [David Golden]
577
578  - skip failing test in par.t if Archive::Zip is broken [David Golden]
579
580  - Added YAML utf8 patch in 0.33_03 changes list
581
582  - Added attribution for patches in 0.33_03 changes list
583
584 0.33_03 - Mon Jun 22 17:22:56 EDT 2009
585
586  Bug-fixes:
587
588  - Removes Module::Build from its own configure/build_requires
589    [David Golden]
590
591  - ConfigData->feature() confirms that modules actually load successfully,
592    not just that they are present. (RT#43557) [David Golden]
593
594  - Module::Build::Compat handling of INSTALL*LIB (RT#43827)
595    [Tony Payne, David Golden]
596
597  - Module::Build::Compat and recursive test files (RT#39171) [Dave Rolsky]
598
599  - Fixed bug linking non-standard XS names on Windows (RT#38065) ["snaury"]
600
601  - Run PL files that don't generate any file (RT#39365)
602    [Matisse Enzer, David Golden]
603
604  - HTML generation failure no longer fatal (RT#36660) [David Golden]
605
606  - realclean might not delete Build.bat on Windows (RT#43863)
607    [Roy Ivy, David Golden]
608
609  - include_dirs parameter now works correctly when given a single
610    string argument (RT#40177) [David Wheeler]
611
612  - Lots of spelling fixes in the POD (RT#45528r) [Lars Dieckow]
613
614  - On Unix-like systems, tilde expansion is more liberal in username
615    characters accepted (RT#33492) [Jon Jensen]
616
617  Other
618
619  - On MSWin32, bumped File::Spec prereq to 3.30 for a variety of fixes
620
621  - Add support for VMS in Unix compatibility mode (RT#42157)
622    [John E. Malmberg
623
624  - Added a can_action($name) method (RT#45172) [brian d foy]
625
626  - Documented that subclass methods should not permanently change
627    current directory (RT#46919) [David Wheeler]
628
629  - META.yml encoded in UTF-8 (RT#43765) [Olivier Mengue]
630
631 0.33_02 - Mon Jun 15 12:23:55 EDT 2009
632
633  Bug-fixes:
634
635  - Fixed tests for bleadperl
636
637 0.33_01 - Sat Jun 13 20:24:42 EDT 2009
638
639  Bug-fixes:
640
641  - Fixed RT#42724: consolidated VMS fixes [patch by Craig Berry]
642
643  - Fixed RT#46338: passthrough Makefile.PL cleans Makefile during distclean
644
645  - Fixed RT#45700: t/compat.t for HP/UX make
646
647  Other:
648
649  - Adds current Module::Build to configure_requires (and build_requires)
650    if no configure_requires is specified
651
652  - Always normalizes version number tuples in META.yml (e.g. 'v1.2.0')
653    (Partially addresses RT#46150)
654
655  - Normalizes a generated dist_version (e.g. from a .pm file) --
656    dist_version set manually in Build.PL is not normalized
657
658  - Documentation update for create_license
659
660  - Minor POD cleanup
661
662 0.33 - Sun May  3 20:16:34 PDT 2009
663
664  Bug-fixes:
665
666  - Fixed RT#45462: Compat.pm needs to reference 'Build.com' on VMS
667    [patch from John Malmberg]
668
669  - Fixed RT#45461: ext.t on VMS [patch from John Malmberg]
670
671  - Fixed RT#43861: Module::Build::PPMMaker has broken PPD name
672    versioning for v5.10+
673
674 0.32_01 - Tue Apr 14 17:14:22 PDT 2009
675
676  Bug-fixes:
677
678  - Module::Build::Compat had stopped adding "PL_FILES => {}" when no
679    PL_files property was set in Build.PL; restored old behavior and fixed
680    tests and documentation related to this issue [David Golden]
681
682  - Caches ExtUtils::CBuilder object in a temporary stash instead of properties
683
684  - Fixed undef resources->license in META.yml (RT #44453).
685
686  - Use $^X instead of 'perl' in t/ext.t [David Golden] (RT #43485)
687
688  Other:
689
690  - Generated META.yml will indicate version 1.4 of the specification
691    (RT #37478) [patch from Alexandr Ciornii]
692
693  - Archive::Tar now the default for generating tarballs on all platforms
694    (avoids problems with incompatible tar binaries)
695
696  - dist_dir() now uses dist_name() and dist_version() accessors rather
697    than using its properties directly. [brian d foy] (RT #45038)
698
699 0.32 - Wed Feb 25 17:40:02 PST 2009
700
701  No changes since 0.31_04.
702
703 0.31_04 - Fri Feb 20 11:04:59 PST 2009
704
705  Other
706
707 - Bumped Test::Harness prereq to 3.16 for latest PERL5LIB fixes (solves
708    test failures when installing Module::Build using CPANPLUS::Dist::Build)
709    [David Golden]
710
711 0.31_03 - Sun Feb  8 14:54:01 PST 2009
712
713  Enhancements
714
715  - added a "prereq_data" action that prints a Perl data structure of
716    all prerequisites; can be loaded by external tools using eval()
717    [David Golden]
718
719  Bug-fixes
720
721  - 'fakeinstall' action warns and skips without ExtUtils::Install 1.32+
722    [David Golden, reported by Zefram]
723
724  - allows Module::Build version mismatch when installing self; works around
725    limitations in CPANPLUS::Dist::Build [David Golden]
726
727 0.31_02 - Tue Jan 27 09:16:43 PST 2009
728
729  Other
730
731  - tests now use File::Temp (added to build_requires); appears to fix
732    Win32 testing heisenbug on directory removal during high system loads
733
734  - use_tap_harness.t will skip unless a release version of TAP::Harness
735    is installed
736
737  - improved diagnostics to ensure_blib() tests in t/lib/MBTest.pm
738
739  Compat
740
741  - passthrough Makefile.PL will now play nice with cpantesters' on
742    exit(0) (RT#32018) [Eric Wilhelm]
743
744  Bug Fixes
745
746  - fix for doubling-up of --prefix (RT#19951)
747
748 0.31012 - Wed Jan 14 01:36:19 PST 2009
749
750  Bug Fixes
751
752  - t/tilde.t maybe actually fixed on MSWin32 now.
753
754 0.31011 - Mon Jan 12 21:57:04 PST 2009
755
756  Bug Fixes
757
758  - t/tilde.t had been failing on MSWin32 (RT#42349)
759
760 0.3101 - Mon Jan 12 13:52:36 PST 2009
761
762  Other
763
764  - added 'mirbsd' as a Unix-type OS [BinGOs]
765
766  - added 'haiku' as a Unix-type OS (backported from bleadperl)
767
768  - skips certain tests on VMS (backported from bleadperl)
769
770  - sets $^X to absolute path in tests (backported from bleadperl)
771
772 0.31 - Sat Dec 20 15:03:33 2008
773
774  Deprecations
775
776  - Use of attributes as class methods is deprecated (this was never a
777    documented feature and appears to only have worked accidentally.)
778
779 0.30_02 - Mon Dec 15 12:23:55 PST 2008
780
781  Bug Fixes
782
783  - make Software::License dependency "softer".
784
785 0.30_01 - Thu Dec 11 18:25:53 PST 2008
786
787  New Docs
788
789  - Added a recipe for writing a new action to the Cookbook
790
791  - Added a recipe for bundling Module::Build to the Cookbook.
792
793  Doc Fixes
794
795  - Clarified dist_abstract search procedure in API.pod (RT#41056) [Mario
796    Domgoergen]
797
798  Bug Fixes
799
800  - Workaround HARNESS_TIMER env issue in t/compat.t (RT#39635)
801
802  - Fix ~ expansion when $HOME is different from /etc/passwd as
803    when running sudo.  [rt.cpan.org 39662]
804
805  - Fixed a small POD error in the Cookbook. [Damyan Ivanov]
806
807  - Unset group/other write permission bits when using Archive::Tar to
808    build the dist tarball. (RT#39804) [David Golden]
809
810  Enhancements
811
812  - We now support a 'create_license' parameter to new() that will
813    create a LICENSE file during the 'dist' phase with the full text of
814    the license.  This requires Software::License on the author's
815    machine.
816
817  - Added lgpl2/lgpl3 entries to the supported licenses (RT#40532).
818
819  - Support for validating properties with a check subref. [David
820    Wheeler]
821
822  Test Fixes
823
824  - Defend against more stray environment variables interfering
825    with the tests.
826
827  Other
828
829  - Updated our embedded version.pm to 0.76, enhanced documentation on
830    dist_version_from.  [John Peacock]
831
832 0.30 - Thu Sep 25 20:57:36 2008
833
834  - First non-beta release since April 2007.  In the meantime, Sarkozy
835    became president of France, the 35W bridge fell in Minneapolis,
836    Phelps won a lot of gold, a new tribe of indigenous people was
837    discovered in the Amazon, and Bob Barker stopped doing The Price Is
838    Right.  As of this moment though, the U.S. economy still hasn't
839    collapsed completely.
840
841 0.2808_05 - Thu Sep 18 23:30:39 PDT 2008
842
843  - Skip test in t/ext.t which tickles shellwords() in Text::ParseWords
844    below 3.23 [David Wheeler, Ken]
845
846  - Fixed some shell-quoting issues in do_system() on Windows [Ken,
847    Schwern, reported by Curtis Jewell]
848
849  - Fixed t/xs.t failure for missing 'const char *' typemap in 5.6
850    [Schwern]
851
852  - Added build_requires for Test::More 0.49 and Test::Harness 2.03.
853    Removed bundled Test::More (was not working for 5.005x anyway).
854    [Schwern]
855
856  - Minimum required perl version is now 5.6.1. [Schwern]
857
858 0.2808_04 - Thu Sep 11 22:51:27 PDT 2008
859
860  - Backed-out incompatible Module::Build::ModuleInfo change (first in
861    0.2808_02.)
862
863 0.2808_03 - Mon Sep  1 14:43:27 PDT 2008
864
865  - Made adjustments for the format changes of recent Test::Harness
866    output. [Nicholas Clark]
867
868  - Fixed the documentation for script_files to indicate that we search
869    bin/ for scripts by default.  It has been this way for several
870    years. [Spotted by Ron Savage]
871
872 0.2808_02 - Wed Jul  9 16:45:08 PDT 2008
873
874  - Experimental support for TAP::Harness with --use-tap-harness option
875    and the tap_harness_args property. [David Wheeler & Eric Wilhelm]
876
877  - Added test_file_exts property for main-run tests other than '*.t'.
878    [David Wheeler]
879
880  - Fixed getcwd()/rmtree() failure case on 5.10+mac where something is
881    unhappy about all of the tests deleting their distgen directory
882    before leaving it. [Eric Wilhelm & David Wheeler]
883
884  - Improved support for parsing qv() in modules' $VERSION
885    declarations, and made $VERSION-parsing errors more verbose. [Jos
886    Boumans]
887
888  - Integrated an omnibus patch for various VMS fixes. [Craig Berry &
889    John E. Malmberg]
890
891  - Some versions of Test::Harness (or something) seem to not be
892    stripping the ".t" suffix when outputting test reports, which was
893    causing one of our tests in t/compat.t to fail.  Fixed. [Spotted by
894    a smoke tester]
895
896  - Most Unix platforms seem to allow hyphens in usernames, so we honor
897    this in our de-tilde-fying methods now. [Spotted by s-murata]
898
899  - If there are multiple assignments to the $VERSION variable in
900    someone's module and this generates warnings, tell the user what
901    line number the problem is at.
902
903  - Added 'gnu' and 'gnukfreebsd' as Unix variants. [Niko Tyni]
904
905  - Fixed a couple bugs in how we quote arguments to external processes
906    when they have to pass through the shell.  Also much more
907    thoroughly tested our quoting now.
908
909  - Edited the Module::Build::API docs prose about the 'license' field
910    in response to some comments on the module-authors mailing list.
911
912  - Fixed a typo in some example code in the Cookbook. [Jeremy Leader]
913
914  - Custom typemaps were being looked for in places that don't quite
915    exist; fixed. [Michael G Schwern]
916
917  - QNX/Neutrino is now considered to be Unix. [rt.cpan.org 32214]
918
919  - Added 'gpl2' and 'gpl3' to the list of valid licenses. [Allen
920    Engelhardt]
921
922  - Fixed our Data::Dumper wrapper's sensitivity to users who might set
923    $Data::Dumper::Terse. [Spotted by Dominique Dumont]
924
925  - Documented the fix_shebang_line() method. [Elliot Shank]
926
927  - Applied the 'const' modifier to version() and xs_version() XS
928    functions we use during testing. [Robin Barker]
929
930  - Fixed processing of INC=, POLLUTE=, INSTALLDIRS=, and LIB= for
931    passthrough/small Makefile.PLs.
932
933  - perl Build.PL --sign=1 now signs. [Michael G Schwern]
934
935  - Fixed processing of INSTALLDIRS=whatever for compatibility
936    Makefiles. [Spotted by John Peacock]
937
938  - Zillions of special-cases have been added in Compat.pm for dealing
939    with the special Makefile system on VMS. [John E. Malmberg]
940
941  - Fixed some stuff in how VMS command-args get quoted. [John E. Malmberg]
942
943  - VMS now overrides localize_file_path() and localize_dir_path() so
944    we don't need to do special stuff in the general case. [John
945    E. Malmberg]
946
947  - Added a few more VMS-specific entries to the default MANIFEST.SKIP
948    file that (sometimes) gets created during the 'manifest'
949    action. [John E. Malmberg]
950
951  - Fixed a catdir() that should have been a catfile() when creating a
952    ppmdist. [John E. Malmberg]
953
954  - Removed some assumptions about what makefiles are called (not
955    necessarily "Makefile") and how they take their arguments, to get
956    VMS tests working better. [John E. Malmberg]
957
958  - Fixed our check for Archive::Tar in the t/runthrough.t test, which
959    fixes a common failure on Win32. [Spotted by Chris Williams]
960
961  - Fixed a File::Spec mal-ism in t/destinations.t [Craig A. Berry]
962
963  - Exposed the internal ExtUtils::CBuilder object as part of our API,
964    via the cbuilder() method. [Zefram]
965
966  - Upgraded to version.pm 0.74 (fixes bug #30004.)
967
968  - Overwrite core (post-5.9.4) Module::Build installs (bug #20528.)
969
970  - Pass quiet() option to ExtUtils::CBuilder object.
971
972 0.2808_01 - Wed Oct 24 11:51:25 2007
973
974  - All .pm files in the Module-Build distribution (except for
975    M::B::Version.pm, which is kind of tied to version.pm) now have the
976    same $VERSION number explicitly specified.
977
978  - When checking prerequisites, the required version of perl is now
979    checked before we start finding the $VERSION declaration of the
980    distribution, which results in much more intuitive error messages
981    e.g. if the author is using 5.6-isms in their declaration but the
982    user doesn't have 5.6. [Slaven Rezic]
983
984  - Added 'artistic_2' license, corrected 'lgpl' license url (bug #29783)
985    [David Thomas]
986
987  - VMS find_perl_interpreter() is just $^X (bug #29810) [Craig A. Berry]
988
989  - Some large VMS fixes, mostly having to do with the non-case-
990    preserving nature of most VMS filesystems, but also correcting for
991    illegal characters in VMS file specs. [John E. Malmberg and Craig
992    A. Berry]
993
994  - Fixed the _detildefy() method on VMS. [John E. Malmberg and Craig
995    A. Berry]
996
997  - We now use a much more reliable method when Data::Dumper-ing saved
998    state data. [Yves]
999
1000  - When a module had 0.000 as its version, a few places in the code
1001    thought the module had no version at all.  This is now
1002    fixed. [Andrew "Zefram" Main]
1003
1004  - When finding the default set of script_files, we now compute them
1005    as relative paths, not absolute. [Spotted by Curtis "Ovid" Poe]
1006
1007  - Got rid of a call to eliminate_macros, which isn't needed in
1008    Module::Build since there is no external make utility involved.
1009    Override expand_test_dir to make up for the fact that the
1010    home-grown glob() returns absolute, not relative, paths. [Craig
1011    A. Berry]
1012
1013  - Fixed a catdir() that needed to be catfile() in the .packlist
1014    creation code. [John E. Malmberg]
1015
1016  - If a *.PL file ended abnormally during the build, processing should
1017    have stopped, but it didn't.  Fixed. [Matthew Cast and David
1018    Golden]
1019
1020  - Module::Build::Compat adds "require 5.XXXXX" to Makefile.PL when
1021    'perl' is specified as a 'requires' prerequisite [David Golden]
1022
1023  - Refactored t/compat.t for modularity and transparency; added
1024    labels for all tests; supressed subprocess output to
1025    STDOUT and STDERR [David Golden]
1026
1027  - Fixed bug in perl_version_to_float when version is already a float
1028    [David Golden]
1029
1030  - Removed a mention of $build->{config} from the documentation, the
1031    official interface to Config.pm settings is now via the
1032    $build->config() and has been for some time. [Suggested by Michael
1033    Schwern]
1034
1035  - Tweaked some text in the Cookbook to bring it into the modern age,
1036    and added a recipe for accessing Config.pm settings. [Ibid]
1037
1038  - Lots of POD link/readability improvements to the Module::Build::API
1039    documentation [Salve J. Nilsen]
1040
1041  - Added configure_requires as a new type of prereq.  [Suggested by Adam
1042    Kennedy]
1043
1044  - Patch 31156 from bleadperl: some filename dot and extension help
1045    for Module::Build on VMS. [Craig Berry]
1046
1047  - Reworked the _detildefy() method so it doesn't depend on glob()
1048    anymore.  This gets rid of a problem with spaces or other special
1049    shell characters in things like 'prefix' or 'install_path'
1050    entries. [Prodding by Eric Wilhelm]
1051
1052  - Added midnightbsd to the list of Unix-like OSes we know about
1053    [Rafael Garcia-Suarez]
1054
1055 0.2808 - Sat Apr 28 12:59:43 2007
1056
1057  - Added is_vmsish(), is_windowsish(), and is_unixish() boolean
1058    convenience functions.  Fixes some test failures on platforms where
1059    $^O is set to a value we don't know about (like 'gnu').
1060
1061  - Upgraded to version.pm 0.7203. [John Peacock]
1062
1063  - Support get_action_docs() =head2 style. [ewilhelm]
1064
1065  - Workaround Test::Pod::Coverage @INC bug. [Eric Wilhelm]
1066
1067  - Fixed the command-line args --extra_compiler_flags and
1068    --extra_linker_flags so they properly shell-split their arguments.
1069
1070 0.2807 - Sat Mar 24 22:19:02 2007
1071
1072  - Upgraded to version.pm 0.71. [John Peacock]
1073
1074  - Removed a couple small constructs in the tests ("use warnings;" and
1075    "qw$foo bar$[1]") that caused test failures under perl 5.005.
1076
1077  - Added support for an explicit default value of undef in prompt().
1078    [Eric Wilhelm]
1079
1080  - Improved our prompt() method, which could sometimes hang before the
1081    user got a chance to see a prompt. [Andreas Koenig]
1082
1083  - Added a note about --allow_mb_mismatch to the error message that
1084    happens right before someone might want to use that parameter.
1085
1086  - Added DragonflyBSD to the list of known Unix OSes.
1087
1088  - get_action_docs() dies on error rather than twiddling $@
1089
1090  - Made ModuleInfo's _evaluate_version_line() compatible with 'use
1091    version ...$VERSION' lines.  [Eric Wilhelm]
1092
1093  - Added some verbiage in Module::Build::API that officially blesses
1094    the _build/prereqs file for external consumption. [Suggested by Andreas Koenig]
1095
1096  - Added test profiles support via the test_types property and "testall"
1097    target. [Eric Wilhelm, Jeff Lavallee]
1098
1099  - Use syscopy() on OS/2 in copy_if_modified() so we make sure to
1100    overwrite any existing target file. [Ilya Zakharevich]
1101
1102  - Removed seemingly silly '~~' test in t/tilde.t.
1103
1104  - In our test-time utility library t/lib/MBTest.pm, we need to know
1105    about a few .exe-like extensions on OS/2. [Ilya Zakharevich]
1106
1107  - In t/ppm.t, use DynaLoader::mod2fname() (if available) to determine
1108    the correct translation of our test module's name into a DLL
1109    name. [Ilya Zakharevich]
1110
1111  - Avoid an unlink() error on OS/2 when fixing shebang lines. [Ilya
1112    Zakharevich]
1113
1114  - When we're protecting the world from the evils of long RedHat
1115    $ENV{PERL5LIB} variables, don't assume $ENV{PERL5LIB} is already
1116    defined.  This gets rid of a huge number of warnings for some
1117    people. [Dave Rolsky]
1118
1119 0.2806 - Fri Dec 15 22:20:14 2006
1120
1121  - On some systems (haven't identified the actual problem yet)
1122    $ENV{PERL5LIB} can grow to enormous enough sizes that we can't
1123    launch any more subprocesses because the environment table is full.
1124    This is the now-infamous "Couldn't run Build.PL: Argument list too
1125    long" error.  Now we detect such situations and trim the directory
1126    list to only include directories that actually exist, listed only
1127    once each.  Not the ideal solution, but it should work.
1128
1129  - Silence a warning in M::B::ModuleInfo that happens when the author
1130    is using the "$VERSION = eval $VERSION" idiom.
1131
1132  - When running the 'testcover' action, do "cover --delete" if any of
1133    the test files have changed (we already did so if any of the code
1134    under test has changed). [Suggested by Chris Dolan, RT #23584]
1135
1136  - Fixed a broken link in the documentation about PREFIX. [Spotted by
1137    David Steinbrunner]
1138
1139  - Changes to do_system() & friends on VMS to get system calls working
1140    much better there. [Craig Berry]
1141
1142  - Added the "pardist" target which creates a PAR binary distribution
1143    akin to a PPM distribution. [Steffen Mueller]
1144
1145  - Added the Interix platform as a Unix variant. [Stephen Hartland]
1146
1147  - Improved the error message we emit when a distribution contains XS
1148    files but the user has no C compiler. [Suggested by Andreas Koenig]
1149
1150 0.2805_01  Thu Sep  7 21:57:29 CDT 2006
1151
1152  - Because of a weird behavior of YAML::Node, any distribution that
1153    used version.pm objects to define their versions was generating the
1154    wrong syntax for the versions in their META.yml file.  They will
1155    now appear as strings like v3.42.1 or similar, including the
1156    leading v.
1157
1158  - Upgraded to version 0.67 of version.pm. [John Peacock]
1159
1160  - Added a contrib/ directory with a bash completion function for M::B
1161    actions and switches. [Julian Mehnle]
1162
1163  - When we eval() the embedded version.pm code we will now die() if
1164    the eval() was unsuccessful, rather than continuing blindly on and
1165    dying mysteriously later.
1166
1167  - Added a 'retest' action that lets users run the current regression
1168    tests on a previously-installed version of a distribution.
1169
1170  * Instead of storing an entire dump of the Config.pm hash in the
1171    _build/ directory upon startup, we now just store any overrides the
1172    user or author has specified.  Note that if you were doing anything
1173    you weren't supposed to be doing, like poking around in the
1174    internals of $buld->{config}, your code might break, so I've put
1175    the asterisk of incompatibility on this one just to cover my
1176    tuchus.  [Idea originally by Randy Sims]
1177
1178  - Made copying files via copy_if_modified() a little less chatty.
1179
1180 0.2805  Sat Jul 29 22:01:24 CDT 2006
1181
1182  - We now embed a copy of version.pm right in the
1183    Module::Build::Version source code, with John Peacock's blessing,
1184    in case the user has a rough time installing version.pm.  This
1185    helps alleviate troubles people were still having with working out
1186    a seemingly circular dependency (even though version.pm now ships
1187    with a standard Makefile.PL too).  A version.pm >= 0.661 installed
1188    on the system will take precedence over our bundled one. [John
1189    Peacock]
1190
1191  - Fix some test warnings (or failures?) related to version.pm
1192    numification. [John Peacock]
1193
1194  - The top-level 'version' entry in META.yml files we'd generated was
1195    in the wrong format (it was being treated as a version.pm object
1196    rather than a serialized copy) due to a weird YAML::Node issue.
1197    Fixed.
1198
1199  - Don't 'use base qw(version)' anymore in our M::B::Version wrapper,
1200    just set @ISA directly, because some people have reported that the
1201    'use base' line is croaking.
1202
1203  - Added an 'allow_mb_mismatch' parameter to suppress the startup
1204    check that ensures the version of M::B currently running is the
1205    same as the one initially used to run the Build.PL.  Use with
1206    caution.
1207
1208  - Module::Build::ModuleInfo will no longer detect things that look
1209    like $VERSION assignments after an __END__ or __DATA__ token.
1210
1211  - Updated documentation to mention the new mailing list on perl.org
1212    rather than the old one on sourceforge.
1213
1214 0.2804  Sun Jul 16 16:41:25 CDT 2006
1215
1216  - Added 'use version;' in Module::Build::Version, because some
1217    versions of base.pm won't automatically load version.pm when we do
1218    'use base qw/version/;'. [Spotted by Erik Tank]
1219
1220 0.2803  Sat Jul 15 08:26:34 CDT 2006
1221
1222  - The META.yml file in the last release was all screwed up, so the
1223    distribution wasn't indexed properly.  Fixed in this release.
1224
1225 0.2802  Fri Jul 14 22:40:34 CDT 2006
1226
1227  - Added reliance on version.pm, which means we should deal much
1228    better with the wide range of version specifications one finds on
1229    CPAN.  This is made possible by recent releases of version.pm that
1230    give the user a pure-perl option, so installing version.pm
1231    shouldn't be too onerous for most users.  [John Peacock]
1232
1233  - We should be accepting the default when we're in unattended mode,
1234    not acting dumb and ignoring both the default and the [empty]
1235    answer from the user.  Fixed.  [Spotted by Nik Clayton]
1236
1237 0.2801  Sun May 21 00:07:40 CDT 2006
1238
1239  - Module::Build::Compat's emulation of INC is incorrectly prepending
1240    a -I to the value of INC. This is incorrect because there should
1241    already be a -I on the value. I.E. it's "perl Makefile.PL INC=-Ifoo"
1242    not "perl Makefile.PL INC=foo" so Compat should not prefix a -I.
1243    [Michael Schwern]
1244
1245  - Native batch scripts under Windows should not be converted by
1246    pl2bat. [Spotted by Ron Savage]
1247
1248  - Tweaked the way we determine whether a file is executable on Unix.
1249    We use this determination to decide whether to make it executable
1250    during installation. [Julian Mehnle]
1251
1252  - Replaced a vestigial 'next' with 'return' now that the code is in a
1253    subroutine (htmlify_pods()), not a loop. [Ron Savage]
1254
1255  - Fixed a guaranteed failure in t/signature.t when TEST_SIGNATURE was
1256    set. [Eric R. Meyers]
1257
1258  - Fixed a test failure that occurred when testing or installing in
1259    unattended mode - the code to test whether unattended mode and
1260    attended mode are working properly was assuming that we started out
1261    in attended mode. [Steve Peters]
1262
1263  - Improved our stand-in YAML generator that we use to generate
1264    META.yaml when authors don't have a copy of YAML.pm installed on
1265    their machine.  It was unable to handle things like embedded
1266    newlines in the data, now it has a much more extensive escaping
1267    mechanism. [Stephen Adkins]
1268
1269  - Revised the docs for --prefix and PREFIX. [Michael Schwern]
1270
1271 0.28  Thu Apr 27 22:25:00 CDT 2006
1272
1273  - When y_n() or prompt() are called without a default value and the
1274    build seems to be unattended (e.g. in automatic CPAN testing), we
1275    now die() with an error message rather than silently returning
1276    undef for prompt(), or looping indefinitely for y_n().
1277
1278  - When searching for '.modulebuildrc', return the first HOME-like
1279    directory that actually contains the file instead of the first
1280    existing directory. Document the search locations and the order
1281    searched. [Spotted by David Golden]
1282
1283  - Split the API documentation out of Module::Build::Authoring into
1284    its own document: Module::Build::API.
1285
1286  - We should not emit a warning if a Module::Build subclass is
1287    required in a Makefile.PL that is not bundled in the current
1288    distribution; it may be installed on the user's system. [Spotted by
1289    Tyler MacDonald]
1290
1291  - copy_if_modified() now preserves the executable bit of the source
1292    file. [Spotted by Julian Mehnle]
1293
1294  - Fixed compatibility of our screen-scraping the Test::Harness output
1295    so we can recognize the most recent Test::Harness version. [Steve
1296    Hay]
1297
1298  - Backing out a requirement added in 0.27_06 on the method y_n()
1299    to always include a default. This behavior would cause existing
1300    build scripts to start failing. We now fail with a missing default
1301    only when $ENV{PERL_MM_USE_DEFAULT} is set because there is no
1302    reasonable default.
1303
1304  - Make install_types() method smarter with respect to custom install
1305    types.
1306
1307  - Add documentation for the install_base_relpaths() and
1308    prefix_relpaths() methods. Improved their usage for a public API,
1309    and added tests.
1310
1311 0.27_10  Tue Mar 28 22:50:50 CST 2006
1312
1313  - Added the create_packlist property, default true, which controls
1314    whether packlist files will be written during installation.  This
1315    was already part of Module::Build 0.2609, but for some reason we've
1316    forgotten it in the 0.27_xx series.  [Spotted by Steve Kirkup]
1317
1318  - Document the versions of Module::Build where each feature, action,
1319    constructor argument, and method was first publicly documented.
1320
1321  - More fixes for find_perl_interpreter() to work with BSD flavored
1322    UNIX: Ensure we always return absolute paths; throw an exception
1323    upon failure to find correct interperter; document everything.
1324
1325  - We now include our own YAML.pm work-alike that we can use when the
1326    real YAML isn't installed.  We might soon even start using it when
1327    YAML is installed, because the YAML API and dependency chain have
1328    been changing in unfavorable ways lately. [Stephen Adkins]
1329
1330  - Fixed some shell-argument-quoting issues on VMS.  In the process,
1331    we have added some support for avoiding tripping over
1332    shell-argument-quoting issues on other platforms too. [Initial
1333    patch by Craig A. Berry]
1334
1335 0.27_09  Sat Mar 11 22:48:54 EST 2006
1336
1337  - Fixed find_perl_interpreter() so we can find the perl executable
1338    when running from uninstalled perl even when $^X contains a
1339    relative path. [Yitzchak Scott-Thoennes]
1340
1341  - Fixed warning message where we were printing the wrong field names.
1342    [Chris Dolan]
1343
1344  - Added a 'testpodcoverage' action that runs a POD coverage check for
1345    all modules in the distribution. [Yanick Champoux]
1346
1347  - Added a Cookbook example of subclassing to modify an action. [Dylan
1348    Martin and David Golden]
1349
1350  - When building HTML documentation, we were opening the POD file and
1351    not checking whether the open succeeded, which of course caused
1352    problems down the line if it failed.  Now we do "or die(...)" like
1353    everywhere else. [Spotted by Joerg Braun]
1354
1355 0.27_08  Fri Mar  3 21:22:41 CST 2006
1356
1357  - Due to shell quoting issues and differences in syntax between
1358    various flavors of Windows, the code for the 'pl2bat' utility
1359    distributed with Perl has been incorporated into M::B::P::Windows.
1360    [Thanks to Dr Bean and Ron Savage for help testing and isolating
1361    the problem.]
1362
1363  - Modify add_build_element() so that it only adds elements if they
1364    don't already exist. [David Wheeler]
1365
1366  - Fixed a bug in the 'pass-through' Makefile.PL in which we would die
1367    if CPAN::Shell->install returned false, but apparently this return
1368    value is unreliable.  Now we only die if the module is actually
1369    unavailable after installation.
1370
1371  - Fixed testing problems on VMS related to non-case-preserving
1372    filesystems.  We now bundle Tie::CPHash in the distribution (just
1373    for testing purposes, it doesn't get installed) to help with
1374    this. [Craig Berry and Yitzchak Scott-Thoennes]
1375
1376  - We incorrectly documented the 'dynamic_config' flag in the META.yml
1377    file as having a default value of false, but according to the
1378    META.yml spec (which, for heaven's sake, we wrote) its default
1379    value is true.  Fixed. [Spotted by Adam Kennedy]
1380
1381  - The have_c_compiler() method was dying if the ExtUtils::CBuilder
1382    module wasn't around, which is obviously an unhelpful thing to do.
1383    Now it just returns false. [Spotted by John Peacock]
1384
1385  - Fix detection of $VERSION expressions that are not
1386    assignments. [Spotted by Chris Dolan]
1387
1388  - Obfuscate one of our constructs that uses a $VERSION variable,
1389    because it was getting picked up by ExtUtils::MakeMaker's
1390    version-finder. [Spotted by Randal Schwartz]
1391
1392  - The config_data script for querying and/or setting a module's
1393    config data was forgetting to call write() after setting config
1394    values (though setting feature values was working fine).
1395    Fixed. [Brian Duggan]
1396
1397  - On Windows, remove the pl2bat generated 'Build.bat' script without
1398    the annoying "The batch file cannot be found." error.  [Solution
1399    provided by RazTK and foxidrive on newsgroup alt.msdos.batch]
1400
1401  - Our version comparisons should now work correctly with modules that
1402    use version.pm to delcare their versions (e.g. "our $VERSION =
1403    version->new('1.0.0')"). [John Peacock and Ron Savage]
1404
1405  - We now create a Build.bat script on versions of Windows where it
1406    makes sense. [Yves]
1407
1408  - Fixed the verbiage around choosing the correct make-alike on
1409    different platforms to suggest using 'perl -V:make'. [Suggested by
1410    anonymous user]
1411
1412 0.27_07  Wed Feb  1 20:07:45 CST 2006
1413
1414  - The notes() method now returns the new value when called with two
1415    arguments, just like when it's called with one argument. [Tyler
1416    MacDonald]
1417
1418  - The notes() method now distinguishes among the values undef, 0, and
1419    the empty string, where previously it didn't. [Tyler MacDonald]
1420
1421  - We now unshift(@INC) rather than push(@INC) for the directory where
1422    a build subclass lives, so that we're sure to pick up the right
1423    version and not some already-installed version. [perlmonkey]
1424
1425  - The SIGNATURE file for version 0.27_06 (and I'm sure for lots of
1426    versions before that too!) was messed up, since we were modifying
1427    some files after signing.  This has been band-aided for the time
1428    being by signing twice. [Reported by Chris Dolan]
1429
1430 0.27_06  Mon Jan 23 21:44:54 CST 2006
1431
1432  - Fixed an undefined-variable warning when building the META.yml file
1433    and the author hasn't used the 'module_name' mechanism. [Chris Dolan]
1434
1435  - We should now work with recent (> 0.49) versions of YAML.pm when
1436    creating the META.yml file. [Yitzchak Scott-Thoennes]
1437
1438  - The y_n() method now requires the default parameter, and the
1439    prompt() and y_n() methods have been improved with respect to
1440    how they behave/detect when there is no user to ask.  We're now
1441    more consistent with MakeMaker, including respecting the
1442    PERL_MM_USE_DEFAULT environment variable. [Tyler MacDonald and
1443    Yitzchak Scott-Thoennes]
1444
1445  - When building a README file using Pod::Text, work around a bug in
1446    Pod::Text 3.01, which expects Pod::Simple::parse_file to take input
1447    and output filehandles when it actually only takes an input
1448    filehandle. [Yitzchak Scott-Thoennes]
1449
1450 0.27_05  Thu Jan 12 17:39:21 CST 2006
1451
1452  - In t/common.pl, we were attempting to let the user's installed
1453    Test::More take precedence over ours, but getting thwarted by all
1454    the test scripts' loading Test::More beforehand.  Fixed. [Spotted
1455    by Yitzchak Scott-Thoennes]
1456
1457  - In various test scripts, we were outputting some strings that
1458    weren't strictly conformant with Test::Harness's expected input,
1459    though it didn't actually cause problems.  Now we're more
1460    conformant, though not yet strict. [Spotted by Yitzchak
1461    Scott-Thoennes]
1462
1463 0.27_04  Fri Dec 23 10:43:34 CST 2005
1464
1465  - Removed experimental feature that extended the prerequisite system
1466    to apply ('requires', 'recommends', and 'conflicts') prereqs to all
1467    actions. Most of the internal extensiblity has been retained so
1468    that prereq types can easily be added, more selectively.
1469
1470  - Added a 'prereq_report' action that shows the user a well-formatted
1471    list of all prerequisites, the versions required, and the versions
1472    actually installed. [David Wheeler]
1473
1474  - Clarified the directory name that's created during the 'distdir'
1475    action. [Suggested by Tyler MacDonald]
1476
1477  - Fixed a bug when creating the META.yml file without the help of
1478    YAML.pm - some common strings weren't quoted & escaped properly.
1479    Now only some uncommon ones are. [Spotted by Joshua ben Jore]
1480
1481  - Fixed a bug in which an "UNINST=1" argument specified to a
1482    passthrough Makefile's "make install" wasn't actually seen by
1483    Module::Build.
1484
1485  - Rather than dying when the Build script is run from the wrong
1486    directory, it now simply chdir()s into the right directory and
1487    keeps going. [Suggested by Dominique Quatravaux]
1488
1489  - Added an "Examples on CPAN" section to the cookbook, with an
1490    initial entry pointing to John Peacock's SVN-Notify-Mirror
1491    distribution.
1492
1493  - Add an invoked_action() method to return the name of the original
1494    action invoked by the user.
1495
1496  - Add 'meta-spec' field to the generated META.yml file, including the
1497    version of the specification followed by the current Module::Build
1498    and the url where the specification can be found.
1499
1500  - Introduced two actions, 'html' & 'manpages', that generate
1501    documentation for POD when the respective feature is enabled.  The
1502    actions will generate the documents even if there is no set place
1503    to install to.  However, if the actions are invoked as a dependency
1504    of another action (e.g. build), the documentation will only be
1505    built when there is a default or user-specified place to install to.
1506
1507  - Added support for environment variable, 'MODULEBUILDRC', which can
1508    be used to specify the full path to an option file to use instead
1509    of the default location of ~/.modulebuildrc. A special undocumented
1510    setting of 'NONE' tells Module::Build not to load any user settings,
1511    so tests can be run without tainting from user options.
1512
1513  - Documented and improved preliminary support for more Getopt::Long
1514    style options are supported, including boolean options (--verbose,
1515    --no-verbose), and use of hyphens in option names in addition to
1516    underscores.
1517
1518  - The option to disable/enable reading of the ~/.modulebuildrc file
1519    is changed from 'skip_rcfile' to 'use_rcfile'
1520
1521  - Allow the 'distmeta' action to continue when 'MANIFEST' is missing,
1522    omitting the generation of the 'provieds' field. [Steven Schubiger]
1523
1524  - Fixed some failing regex from generated MANIFEST.SKIP file.
1525
1526  - Fixed an edge case in $VERSION parsing where we thought a package()
1527    declaration was happening but it wasn't. [David Golden]
1528
1529  - Added docs for the install_destination() and install_types() methods.
1530
1531 0.27_03 (Beta for 0.28)  Mon Oct 10 11:19:23 EDT 2005
1532
1533  - We now use ExtUtils::CBuilder to do all compiling of C code (for
1534    example, when compiling XS modules).  (This change actually
1535    occurred in 0.27_01, but it was mistakenly omitted from the Changes
1536    file.)
1537
1538  - Fixed an issue on Win32 (and other case-tolerant
1539    non-case-preserving systems, possibly like VMS?) in which the
1540    current working directory would sometimes be reported with
1541    different case, fooling us into thinking that we were in the wrong
1542    directory. [David Golden]
1543
1544  - The extra_compiler_flags setting was not actually being passed
1545    along to ExtUtils::CBuilder so it could pass it along to the
1546    compiler.  Now it is.
1547
1548  - The synonyms 'scripts' and 'prereq' for 'script_files' and
1549    'requires' were broken in a previous version (0.27_01, probably),
1550    but now they're fixed. [David Golden]
1551
1552  - Previously, we assumed that any custom subclass of Module::Build
1553    was located in _build/lib/.  This is only true if the author used
1554    the subclass() method, though.  We now use %INC to find where the
1555    custom subclass really is, so that we can "use lib" it.  We also
1556    issue a warning if it seems to be outside the build directory.
1557    [Spotted by Peter Tandler]
1558
1559  - Added a URL for each license type that we know about, which will
1560    appear as resources=>license: in the generated META.yml file.
1561
1562  - If the user passes a no_index parameter to our constructor, we now
1563    pass that through when building the META.yml file. [Richard
1564    Soderberg, RT #9603]
1565
1566  - A few more status messages can now be suppressed by using 'quiet'
1567    mode.  [Dave Rolsky]
1568
1569  - Added some more entries to the default MANIFEST.SKIP file. [Chris
1570    Dolan]
1571
1572  - Our POD parser will now accept "AUTHORS" as well as "AUTHOR" when
1573    looking for the author list in a module. [David Wheeler]
1574
1575  - When looking for the POD to auto-generate a README file, or for the
1576    AUTHOR or ABSTRACT for the distribution, we now also look for a
1577    *.pod with the same name as the *.pm file specified by
1578    'version_from'. [David Golden]
1579
1580  - The recommended dependency on ExtUtils::ParseXS has been moved into
1581    the "C_support" auto_feature.
1582
1583  - When building XS files, we now pass the -DVERSION and -DXS_VERSION
1584    flags to the compiler. [Spotted by Jerry Hedden]
1585
1586  - If a distribution has XS files and Module::Build has not been
1587    configured with the "C_support" feature, we now issue a
1588    warning. [Suggested by Jerry Hedden]
1589
1590  - Added a dir_contains() method.
1591
1592  - Some versions of MakeMaker, CPANPLUS, and/or PAUSE thought that a
1593    certain line of our code was declaring a $VERSION when we didn't
1594    intend to.  The line has been obscurified so they won't think that
1595    anymore. [Jos Boumans, RT #14226]
1596
1597  - Added the Apache, MIT, and Mozilla licenses to the list of licenses
1598    that this module knows about. [Bob Ippolito]
1599
1600  - Fixed a pretty significant typo in the documentation for
1601    auto_features. [Spotted by Jonas B. Nielsen]
1602
1603  - In order to aid people who want to do customization of the META.yml
1604    file, we've added a "metafile" property that can then be easily
1605    overridden in subclasses, changed do_create_meta_yml() to
1606    do_create_metafile(), and split out the code that actually
1607    generates the YAML into a new method, write_metafile(). [David
1608    Wheeler]
1609
1610  - Fixed a couple of non-helpful behaviors with extra_compiler_flags
1611    and extra_linker_flags.  These will automatically be run through
1612    split_like_shell() when given to new() as strings.
1613
1614  - When the user doesn't have ExtUtils::ParseXS installed and we use
1615    the old 'xsubpp', the displayed command line for creating the .c
1616    file from the .xs file was missing its newline.  Now it's got it.
1617
1618 0.27_02 (Beta for 0.28)  Fri Jul 15 07:34:58 CDT 2005
1619
1620  - Provided initial support for the --prefix installation parameter,
1621    which acts like MakeMaker's PREFIX.  It is still highly recommended
1622    NOT to use it when you could reasonably use --install_base or
1623    --install_path or --install_dest, but that's just because the way
1624    --prefix is designed is weird and unpredictable.  Ultimately the
1625    choice rests with the installing user. [Patches by Michael Schwern
1626    and Rob Kinyon]
1627
1628  - Fixed a bug in subclass() which prevented people from using it to
1629    subclass subclasses of Module::Build. [Chris Dolan]
1630
1631  - Added a 'pure_install' action, which for the time being is
1632    identical to the 'install' action. [Jos Boumans]
1633
1634  - Fixed a POD error in an L<http://...> tag. [Offer Kaye]
1635
1636  - Note several options for automatically creating a new module dev
1637    tree. [Suggested by Eric Wilhelm]
1638
1639  - Removed some hard-coded references to File::Spec::Unix in the
1640    creation of HTML docs, which should help that code work in more
1641    places, and help people not to panic when they look at it. [Spotted
1642    by Yves]
1643
1644  - We now use Pod::Readme by default (instead of Pod::Text) to
1645    generate the README file when the 'create_readme' option is used.
1646    If Pod::Readme is not installed, we will still fall back to using
1647    Pod::Text.  [Robert Rothenberg]
1648
1649  - The values of the "prefix", "install_base", "install_path", and
1650    "install_dest" parameters can now begin with "~" or "~user", and
1651    we'll de-tilde-ify them by using glob().
1652
1653  - The (optional) auto-creation of the README and Makefile.PL files
1654    have been moved from the 'distdir' action to the 'distmeta'
1655    action. [David Golden]
1656
1657  - When looking for a .modulebuildrc file, we now use a fancier method
1658    of trying to find the home directory, because $ENV{HOME} isn't a
1659    very cross-platform variable. [Robert Rothenberg]
1660
1661  - We now memoize the output of the internal _default_INC() method,
1662    since it uses backticks and might be kind of slow.
1663
1664  - When processing XS files, we now look for a typemap in lib/ as well
1665    as using the system's default typemap. [John Peacock]
1666
1667  - The DESTDIR, PREFIX, and INSTALL_BASE arguments to "make install"
1668    are now supported for pass-through Makefiles (they've been
1669    supported for quite a while as arguments to "perl
1670    Makefile.PL"). [Requested by Guillaume Rousse]
1671
1672  - Test::Harness has changed its output format in recent versions,
1673    which threw off one of our tests.  We now allow for this different
1674    format. [Reported by Scott Godin]
1675
1676  - Fixed an issue that prevented Module::Build from upgrading itself
1677    using its own API (which is how CPANPLUS uses it).  There are still
1678    some issues with this solution, however.  See ticket #13169 in
1679    rt.cpan.org. [Reported by Jos Boumans]
1680
1681  - Fixed a fatal error that occurred when a distribution's author
1682    could not be determined from its POD nor from the call to
1683    Module::Build->new() in its Build.PL.  See ticket #12318 in
1684    rt.cpan.org. [Reported by Jos Boumans]
1685
1686  - Apparently on Windows and cygwin it's not possible to use the "-pi"
1687    switch to perl without a backup extension, so now we use ".bak" and
1688    remove the backup file when we're done.  Thus the "dist" action for
1689    Module::Build itself can now be run on those platforms. [Yitzchak
1690    Scott-Thoennes]
1691
1692  - Improved the handling of auto_features in the config_data access
1693    script. [Yitzchak Scott-Thoennes]
1694
1695 0.27_01 (Beta for 0.28)  Fri Apr 15 21:12:57 CDT 2005
1696
1697  Backward-incompatible (but better) changes:
1698
1699  * When using the 'install_base' option to choose a directory for
1700    installing everything, perl modules now go into lib/perl5/ instead
1701    of just lib/.  It seems this is more consistent with people's
1702    expectations, and the way I had it before was a bit peculiar to the
1703    way I like things in my own home directory. [Michael Schwern]
1704
1705  * When the user is using the 'install_base' option, scripts will now
1706    be installed by default in $install_base/bin/ rather than
1707    $install_base/script/ . [Jan Hudec and Michael Schwern]
1708
1709  Major changes:
1710
1711  - The auto_features mechanism will now re-evaluate dependencies every
1712    time feature() is called for an auto-feature, rather than freezing
1713    the success/failure value during 'perl Build.PL' and using that
1714    value for all eternity (or module update, whichever comes first).
1715    This applies to both $build->feature() and
1716    FooModule::ConfigData->feature() calls. [Requested by many]
1717
1718  - Added the meta_add and meta_merge mechanisms, which let the module
1719    author add/merge arbitrary entries into the META.yml file.
1720
1721  - Now reads per-action default options from '$ENV{HOME}/.modulebuildrc'
1722    if it exists. Command line options override anything set in the rc file.
1723
1724  - We now use ExtUtils::CBuilder to do all compiling of C code (for
1725    example, when compiling XS modules).
1726
1727  - The creation of Unix man pages is no longer a strict necessity - it
1728    has now been turned into an 'auto-feature' contingent on the
1729    presence of Pod::Man and a location specified for man pages to go.
1730
1731  - A user-specified 'install_path' setting will now take precedence
1732    over an 'install_base' setting.  This allows the user to use
1733    'install_base' to set the base for all elements in one go, and then
1734    use 'install_path' to override specific paths or add paths for
1735    additional kinds of targets.
1736
1737  - Split the main documentation from 'Module/Build.pm' into two
1738    sections. The user level documentation and overview remains in
1739    'Module/Build.pm', while a new document,
1740    'Module/Build/Authoring.pod', has been created for module authors.
1741
1742  Minor changes:
1743
1744  - new_from_context() was losing its arguments in some cases (and not
1745    because of inadequate training in forensic debate) - we now pass its
1746    arguments directly to the Build.PL script rather than merging them
1747    in afterwards.
1748
1749  - Let resume() return an object blessed into the appropriate class
1750    if the user has provided a subclass, as specified by the
1751    'build_class' property. This allows current() and new_from_context()
1752    to behave more like factory methods returning objects of the correct
1753    class based on context. [Ray Zimmerman]
1754
1755  - Refactored methods relating to parsing perl module files for
1756    package, version, and pod data into a new class:
1757    Module::Build::ModuleInfo.  It should not be considered part of
1758    Module::Build's API, because we may split it out entirely as a
1759    separate CPAN module that we depend on.
1760
1761  - Added new method Module::Build::prepare_metadata() for authors to
1762    override in order to add custom fields to META.yml.
1763
1764  - We now use Test::More for our regression tests.  If the user
1765    doesn't have it installed, we include a copy in t/lib/ that we can
1766    use during testing.
1767
1768  - When copying files in the 'distdir' action, set permissions to match
1769    the original files. [Julian Mehnle]
1770
1771  - When adding files like META.yml to the MANIFEST, we now tell the
1772    user we're doing so by printing one of the "Added to MANIFEST: ..."
1773    lines.  [Ron Savage]
1774
1775  - Added a runtime_params() method, which lets a module author see
1776    which parameters were overridden by the user on the command line
1777    (or in whatever paradigm the user originally invoked Module::Build
1778    from). [David Wheeler]
1779
1780  - Added the current_action() method, which, surprisingly, returns the
1781    name of the currently running action. [David Wheeler]
1782
1783  - Added docs for run_perl_script().
1784
1785  - Added some stuff to the docs about why PREFIX is unsupported, and
1786    what to use instead. [Steve Purkis]
1787
1788  - The simple get/set accessor methods for all the 'parameters' like
1789    verbose(), license(), etc. now have auto-generated documentation in
1790    Module/Build.pm.
1791
1792  - Created a Cookbook entry for 'Adding new elements to the install
1793    process'
1794
1795  - We now add META.yml to the MANIFEST when META.yml is created, not
1796    when MANIFEST is created. [Spotted by Ron Savage]
1797
1798  - Added some additional patterns to the suggested MANIFEST.SKIP
1799    contents, and changed the docs so that we encourage the user to use
1800    the MANIFEST.SKIP.  [Ron Savage]
1801
1802  - Eliminated a redundant recipe from the Cookbook, now that there are
1803    some more extensive recipes on how to add stuff to the
1804    build/install sequences.
1805
1806  - Eliminated an undefined-variable warning when testing under perl 5.005
1807
1808  - When building HTML documentation, 'html_backlink' and 'html_css'
1809    properties are now first-class properties, so they can be set from
1810    the command line. [Suggested by Sagar R. Shah]
1811
1812  - Have script_files default to everything in bin.  I believe this is
1813    the least surprising behavior. [Suggested by Michael Schwern]
1814
1815  - If script_files is given a directory, consider each file in that
1816    directory tree as a script to be installed.  This avoids having to
1817    remember to add to the script_files list every time you add a
1818    program. [Suggested by Michael Schwern]
1819
1820  - We now only load Pod::Man when we actually need to build man pages.
1821
1822  - We now make Test::Harness use our carefully-selected path to a perl
1823    executable regardless of Test::Harness's version.  Previously we
1824    let it figure stuff out for itself if it was a reasonably modern
1825    version, but it's safer to make sure we're using the same perl
1826    everywhere.
1827
1828 0.2610  Fri Apr 15 08:25:01 CDT 2005
1829
1830  - new_from_context() was losing its arguments in some cases (and not
1831    because of inadequate training in debate) - we now pass its
1832    arguments directly to the Build.PL script rather than merging them
1833    in afterwards. [Ray Zimmerman]
1834
1835  - Fixed a bug in which config_data and feature data were being
1836    forgotten and no ConfigData.pm module would get written. [Ray
1837    Zimmerman]
1838
1839  - Added a recipe to the cookbook showing how to run a single test
1840    file from the command line. [William McKee]
1841
1842  - For command-line arguments, we now accept the syntax "--foo=bar" in
1843    addition to "--foo bar" and "foo=bar".  This seems to fit well with
1844    what GNU getopt and Getopt::Long do, and with people's
1845    expectations. [Adam Spiers]
1846
1847 0.2609  Wed Mar 16 22:18:35 CST 2005
1848
1849  - The html docs that were created during the first invokation of
1850    './Build' were being found and treated as pod that needed to be
1851    converted to html during subsequent invokations. We now are more
1852    specific about the directories we scan for pod that needs to be
1853    converted, effectively avoiding blib/html. [Ray Zimmerman]
1854
1855  - If Pod::Man is not available, we now skip building man pages
1856    (rather than dying) and tell the user why.
1857
1858  - We now write a .packlist file upon installation, in the same place
1859    that ExtUtils::MakeMaker does. [Johnny Lam]
1860
1861  - On some Unix platforms (BSD derivatives, mostly) perl's $^X
1862    variable isn't set to the full path of the perl executable, just
1863    'perl', when the 'Build' script is run as './Build' and not 'perl
1864    ./Build'.  This can lead to some other modules (maybe
1865    Test::Harness, maybe IO::File, I dunno...) getting very confused
1866    about where they are, and they try to load stuff from the wrong
1867    perl lib, and big trouble ensues.  To fix this, we now set $^X to
1868    the value of Module::Build->find_perl_interpreter().
1869
1870  - The 'distcheck' action will now die() if it finds an error in the
1871    MANIFEST, rather than just printing on STDOUT. [David Golden]
1872
1873  - When the README and/or Makefile.PL are autogenerated using
1874    create_readme or create_makefile_pl, we now automatically make sure
1875    they're also listed in the MANIFEST file. [Suggested by Michael
1876    Schwern]
1877
1878  - Got rid of the t/MANIFEST file - it's superfluous, and it had
1879    zero-length, which some versions of Tar don't like. [William
1880    Underwood]
1881
1882  - Added a mention in the documentation that each property that new()
1883    accepts also has a corresponding get/set accessor.  (In the version
1884    0.27_0x series each accessor method is mentioned explicitly in the
1885    docs.) [Omission spotted by Ian Langworth]
1886
1887 0.2608  Wed Jan 26 19:46:09 CST 2005
1888
1889  - Add workaround for test files because Devel::Cover causes
1890    require to fail when the argument to require is an expression
1891    involving File::Spec. We now assign the result of the File::Spec
1892    call to a variable and then call require with that variable.
1893
1894  - Tilde-expansion is now performed on arguments passed to a
1895    compatibility-Makefile.PL [Spotted by Sam Vilain]
1896
1897  - We now run the 'gzip' and 'tar' values through split_like_shell()
1898    when running the 'dist' action, so that e.g. the 'gzip' value can
1899    be set to something like "gzip -f --best" and it'll work
1900    correctly. [Spotted by Chris Dolan]
1901
1902  - Work around some bad mojo between Fedora Core [with its very long
1903    @INC] and old versions of Test::Harness [with its propensity to
1904    compound the number of @INC entries] that produced an "argument
1905    list too long" error during testing.  [assisted by Ville Skytta,
1906    David Golden, & Randy Sims]
1907
1908  - Killed an infinite loop that would happen in y_n() in interactive
1909    mode if the author provided no default value. [Max Maischein]
1910
1911 0.2607 (Bug fix release in 0.26 series)  Sat Dec 18 14:14:09 CST 2004
1912
1913  - Instead of freezing @INC in the 'Build' script to the value it had
1914    when Build.PL was run, we now just add those additional values that
1915    aren't part of the default compiled-in @INC. [Michael Schwern]
1916
1917  - The run_perl_script() method will now propagate any extra entries
1918    in @INC (such as those added by "use lib" or the -I command-line
1919    switch) to the subprocess.  This helps situations in which you want
1920    to tell the subprocess where to find a certain module, for
1921    instance.  [Michael Schwern]
1922
1923 0.2606 (Bug fix release in 0.26 series)   Tue Dec  7 22:33:11 CST 2004
1924
1925  - Fixed a linking bug on Win32, in which compiled C code object files
1926    never got linked in with the modules being built. [Dominic
1927    Mitchell]
1928
1929  - Fixed a bug in the new_from_context() method in which any arguments
1930    passed made us die. [Spotted by Jos Boumans]
1931
1932 0.2605 (Bug fix release in 0.26 series)   Tue Nov 30 07:16:13 CST 2004
1933
1934  - Fixed a bug in which zero-length arguments for hash-valued
1935    parameters (e.g. " --config foo= ") weren't being allowed.
1936
1937  - The tests now play better with environments in which version.pm is
1938    pre-loaded, like in bleadperl. [John Peacock & Michael Schwern]
1939
1940  - Fixed a syntax error in one of the tests under perl 5.005.
1941
1942 0.2604 (Bug fix release in 0.26 series)   Wed Nov 17 14:32:42 CST 2004
1943
1944  - Fixed a split_like_shell() bug introduced in 0.2603 for Windows, in
1945    which an array reference passed as an argument was returned as an
1946    array reference, rather than as a list. [Spotted by Steve Hay]
1947
1948  - module_name() will now return '' instead of undef when module_name
1949    is not set.  This eliminates a couple uninitialized-value
1950    warnings. [Suggested by Michael Schwern]
1951
1952  - The expand_test_dir() method will now skip dotfiles (like ._foo.t,
1953    which sometimes gets automatically created on Mac systems) when
1954    'recursive_test_files' is in effect. [Tom Insam]
1955
1956 0.2603 (Bug fix release in 0.26 series)   Mon Nov 15 10:28:00 CST 2004
1957
1958  - Added documentation for the new_from_context() method.
1959
1960  - Completely rewrote the split_like_shell() method for the Windows
1961    platform so it works like the command.com shell. [Randy Sims]
1962
1963 0.2602 (Bug fix release in 0.26 series)   Thu Nov  4 11:19:29 CST 2004
1964
1965  - The two bug fixes in 0.2601 gnashed against each other incorrectly,
1966    resulting in a Win32 bug in split_like_shell().  Fixed.  [Spotted
1967    by Steve Hay & Randy Sims]
1968
1969  - Removed a couple of 'use warnings' statements from the code - they
1970    were causing compile failures on 5.005_04, where warnings.pm isn't
1971    available. [Blair Zajac]
1972
1973 0.2601 (Bug fix release in 0.26 series)   Wed Nov  3 20:09:27 CST 2004
1974
1975  - Fixed some backslash problems with split_like_shell() on
1976    Win32. [Steve Hay]
1977
1978  - Fixed a bug in split_like_shell() in which leading whitespace was
1979    creating an empty word, manifesting as something like "gcc - no
1980    such file or directory" during tests. [Spotted by Warren L. Dodge]
1981
1982 0.26  Sat Oct  9 17:51:01 CDT 2004
1983
1984  - Removed some language from the Module::Build::Compat documentation
1985    that encouraged people to include a Build.PL without a Makefile.PL.
1986    Also changed "a replacement for MakeMaker" to "an alternative to
1987    MakeMaker" in the main documentation, which is basically what I
1988    meant all along (i.e. a replacement for MakeMaker in your
1989    particular build process - MakeMaker is never going to be fully
1990    replaced in the perl world at large, of course), but some people
1991    got the impression I was a little more truculent toward MakeMaker
1992    than I really am.
1993
1994  - Added the formal concepts of "features" and "config data" for
1995    distributions.  This allows the module author to define a certain
1996    set of features that the user can switch on and off (usually
1997    according to whether they have the proper prerequisites for them),
1998    and to save build-time configuration information in a standardized
1999    format.  See the main documentation of Module::Build for more
2000    details.  (Note that the name of this system was called
2001    "BuildConfig" for a while in beta, but now it's called
2002    "ConfigData".)
2003
2004  - Added an 'auto_features' capability, which simplifies the process
2005    of defining features that depend on a set of prerequisites.
2006
2007  - Added the 'get_options' parameter, which lets module authors
2008    declare certain command-line arguments their Build.PL can accept
2009    [David Wheeler]
2010
2011  - Changed the split_like_shell() method to use the shellwords()
2012    function from Text::ParseWords (a core module since 5.0), which
2013    does a much better job than the split() we were using.
2014
2015  - Added a 'testpod' action, which checks the syntactic validity of
2016    all POD files in the distribution using Test::Pod.  This eliminates
2017    the need for doing so in a regression test. [Initial patch by Mark
2018    Stosberg]
2019
2020  - Added a process_files_by_extension() method, which generalizes the
2021    kind of processing (essentially just copying) that happens for .pm
2022    and .pod files, and makes it available to other user-defined types
2023    of files.  See the new cookbook entry.
2024
2025  - Improved compatibility with version.pm when authors are using
2026    version objects as their $VERSION variables.  Now
2027    version_from_file() can deal with these objects.  Currently we
2028    stringify them right away, but perhaps in the future we will
2029    preserve them as objects for a while.
2030
2031  - During 'distdir' and 'distmeta' actions, die a bit more gracefully
2032    if there's no MANIFEST (i.e. explicitly say that a MANIFEST is
2033    required). [Spotted by Adrian Howard]
2034
2035  - Eliminated a recursive dependency between creating the MANIFEST
2036    file and creating the META.yml file.  [Spotted by Dave Rolsky]
2037
2038  - On Win32, where a single directory might be known variously as
2039    "Module-Build-0.25_03" or "MODULE~1.25_", we now use
2040    Win32::GetShortPathName($cwd) to verify that the 'Build' script is
2041    being run from the correct directory, rather than just a string
2042    comparison.
2043
2044  - The add_to_cleanup() method will now accept glob()-style patterns
2045    in addition to explicit filenames.  Also documented the fact that
2046    they can be specified in either Unix-style or native-style
2047    notation.
2048
2049  - Passing a PREFIX value to a pass-through Makefile 'make install'
2050    now has the same effect as passing it to 'perl Makefile.PL' (it
2051    dies with a helpful message).
2052
2053  - Added the 'testcover' action, which runs a test suite using
2054    Devel::Cover.  [Dave Rolsky]
2055
2056  - Added the 'lib' and 'arch' installation directories to the search
2057    path for the 'diff' action, since they won't necessarily (though
2058    they usually will) be in @INC at installation time. [Suggested by
2059    Kevin Baker]
2060
2061  - The "=head3" POD directive isn't supported in older podlators
2062    (particularly Pod::Man), so we don't use it anymore.
2063
2064  - Fixed a typo & improved the docs in the SUBCLASSING section. [Ron
2065    Savage]
2066
2067  - Added the '.tmp' suffix to the default MANIFEST.SKIP file, which
2068    should avoid adding things like pod2htmi.tmp to the MANIFEST [Ron
2069    Savage]
2070
2071  - Backup files from Emacs, containing the string '.#' in their names,
2072    should no longer find their way into the blib/ directory (and from
2073    there into installation directories).
2074
2075  - Worked around an unpleasant interaction between version.pm and the
2076    version-checking code that makes sure Module::Build's version
2077    hasn't changed during the lifetime of the 'Build' script. [Reported
2078    by Trevor Schellhorn]
2079
2080  - Fixed a problem in htmlify_pods() that would produce test failures
2081    on Cygwin (and probably elsewhere).  [Yitzchak Scott-Thoennes]
2082
2083  - Fixed a test failure on Cygwin (and probably elsewhere) in
2084    t/compat.t, resulting from empty environment variables being set to
2085    the empty string (as opposed to simply being unset) by their mere
2086    presence in the "EXPORT:" list.
2087
2088  - Fixed a fatal error that occurred when the author specified
2089    'dist_author' manually in their Build.PL script. [Spotted by Ron
2090    Savage]
2091
2092  - The 'provides' section of the META.yml file wasn't being built
2093    properly on Win32, because of a mismatch between URL-format and
2094    native-format pathnames.  Fixed.  [Reported by Robert Rothenberg]
2095
2096  - The progress message "lib/Foo.xs -> lib/Foo.c" was previously being
2097    output even when the Foo.c file wasn't being rebuilt.  It's now
2098    fixed.
2099
2100  - Fixed a couple of places in Compat.pm where it could have forgotten
2101    which perl interpreter it had been run with ($^X isn't very
2102    trustworthy).
2103
2104  - On some systems, the way we updated the timestamp on the
2105    "lib/Foo.bs" file (one of the output files for XS-based modules)
2106    was failing.  It's been replaced by a simple call to utime().
2107
2108  - Fixed a problem in t/compat.t that prevented it from being run
2109    individually using 'make test TEST_FILES=t/compat.t'.  The problem
2110    was that a couple environment variables (TEST_FILES, MAKEFLAGS)
2111    were being passed through to subprocesses, and confused them.
2112
2113  - Fixed an important typo in the documentation for the 'install_base'
2114    parameter ('libdoc' and 'bindoc' were switched). [Ray Zimmerman]
2115
2116  - The pass-through Makefiles (type 'small' or 'passthrough') now
2117    support the TEST_FILES parameter to 'make test'.
2118
2119  - Fixed a fatal error that would occur on perl 5.005 when building
2120    HTML documentation, because its version of Pod::Html was old and
2121    didn't like some of the parameters we fed it. [Spotted by Blair
2122    Zajac]
2123
2124  - The final line of the generated pass-through Makefile was missing
2125    its trailing newline, which is now fixed. [Chip Salzenberg]
2126
2127  - We now depend on YAML version at least 0.35 and at most version
2128    0.49, so that we don't pick up a new (and backward-incompatible) beta
2129    version from CPAN.
2130
2131  - Squashed a warning in t/basic.t about '"Foo::Module::VERSION" used
2132    only once', and one in PPMMaker about $^V being undefined. [Blair
2133    Zajac]
2134
2135  - Added a couple temporary output files from HTML documentation
2136    generation to the cleanup list.  [Toby Ovod-Everett]
2137
2138  - The PodParser module will now only extract paragraphs in the
2139    'AUTHOR' section of the pod if they contain an '@' character.  This
2140    tends to do a better job, heuristically speaking, of returning
2141    relevant stuff.
2142
2143  - Added regression tests and a helper method ( add_build_elements() )
2144    for adding new elements to the build process.  Also some
2145    documentation.
2146
2147  - Wrote a recipe in the Cookbook for adding new elements to the build
2148    process, and a recipe for changing the order in which the steps in
2149    the build process will occur.
2150
2151 0.25  Sun Apr 25 11:12:36 CDT 2004
2152
2153  - During the 'distdir' action, if no MANIFEST.SKIP file exists, we
2154    will now create a reasonable default one. [Randy Sims]
2155
2156  - In Makefile compatibility mode, some arguments (like UNINST,
2157    TEST_VERBOSE, etc.) given to 'make' are now recognized and passed
2158    through to Module::Build. [Randy Sims]
2159
2160  - The regression tests now make sure that several pass-through
2161    Makefile.PL parameters are dealt with correctly.
2162
2163  - Added support for the 'LIB' parameter to passthrough
2164    Makefile.PLs. [Spotted by Jesse Erlbaum]
2165
2166  - Passing a 'PREFIX' parameter to a passthrough Makefile.PL was
2167    supposed to make it die with a helpful error message, but instead
2168    it just ignored it and blindly tried to install to the wrong place.
2169    This is now fixed.  [Spotted by Jesse Erlbaum]
2170
2171  - Added an extra_compiler_flags() accessor method.
2172
2173  - If the 'recursive_test_files' option was turned on, the test files
2174    weren't sorted, but returned in an apparently random order.  Now
2175    they're sorted.  [Martyn Peck]
2176
2177  - Documented the 'tar' and 'gzip' parameters to the 'dist' and
2178    'ppmdist' actions.
2179
2180  - The generation of HTML documentation now works (it was accidentally
2181    partially implemented with an itchy patch-application finger in
2182    0.24).  [Randy Kobes]
2183
2184  - Fixed a fatal bug when building META.yml with YAML.pm and
2185    'dynamic_config' is set. [Reported by Jaap Karssenberg]
2186
2187  - Fixed some incorrect error messages that occurred when
2188    compiling/linking C sources went awry.
2189
2190  - If the author uses a custom builder subclass, that subclass will
2191    now be loaded correctly in the passthrough Makefile.PL if the
2192    author uses the 'small' or 'passthrough' Makefile.PL options in
2193    Module::Build::Compat. [Martyn Peck and Jaap Karssenberg]
2194
2195  - If the author uses a custom builder subclass created dynamically
2196    through the subclass() method, passthrough Makefile.PLs (of type
2197    'passthrough' or 'small') didn't work properly, because the custom
2198    builder module wouldn't be loaded at the right time.  This has been
2199    fixed.  [Reported by Toby Ovod-Everett]
2200
2201  - In M::B-generated 'traditional' Makefile.PLs, the entries in
2202    'PREREQ_PM' are now sorted ASCIIbetically rather than randomly.
2203
2204  - The install_types() method will now return any additional types
2205    given as 'install_path' arguments, as well as all elements of the
2206    current 'install_sets' entry.  This makes it easier to add new
2207    types of installable objects to the mix.
2208
2209  - As a consequence of the previous change, there is no longer any
2210    need to have an explicit 'install_types' data member, so it has
2211    been removed.
2212
2213  - In the second example code for the Module::Build->subclass()
2214    method, the Module::Build module needed to be loaded before calling
2215    its methods. [John Peacock]
2216
2217  - Fixed minor error in the POD structure of Module::Build and
2218    Module::Build::Platform::VMS docs.
2219
2220
2221 0.24  Wed Feb 25 15:57:00 CST 2004
2222
2223  - Fixed a problem with incude_dirs not being propagated to the 'ccs'
2224    file when compiling XS files on Win32. [Randy Sims and Steve Hay]
2225
2226  - In 0.23, Module::Build::Compat->fake_makefile() started choking
2227    when no 'build_class' parameter was supplied in the Makefile.PL.
2228    Since these Makefile.PLs still exist on CPAN, we now default
2229    'build_class' to 'Module::Build', which was the old 0.22 behavior
2230    anyway.  [Reported by Martin Titz and Jeremy Seitz]
2231
2232  - Added documentation for the 'include_dirs' parameter to
2233    new(). [Steve Hay]
2234
2235  - Changed the no-op command on Win32 from 'rem' to 'rem>nul' inside
2236    pass-through Makefiles. [Randy Sims]
2237
2238  - The 'autosplit' parameter now accepts an array reference if
2239    multiple files should be split. [Jaap Karssenberg]
2240
2241  - find_perl_interpreter() will now use $^X (if absolute), $ENV{PATH}
2242    (if $^X isn't absolute), and $Config{perlpath}, in that order.
2243    Also, we now make darn sure the result is the same version of perl,
2244    by checking Config::myconfig() for a match against the current
2245    perl.  [Reported by Edward Sabol]
2246
2247  - Fixed a fatal error on Win32 (and any other platform that doesn't
2248    define an installation location for Unix-style man pages) during
2249    installation.
2250
2251 0.23  Sun Feb  8 22:01:18 CST 2004
2252
2253  - Fixed a compatibility problem in pass-through Makefiles (created by
2254    Module::Build::Compat).  Some 'make' utilities (for example, BSD
2255    make) didn't like a '@' by itself on a line, so we stole some
2256    'NOOP' code from MakeMaker to fix it. [Reported by Mathieu Arnold]
2257
2258  - Added a 'ppm_dist' action, which just makes the PPD file and then
2259    makes a tarball out of the blib/ directory. [Randy Sims]
2260
2261  - The @INC of the parent process is now propagated to child processes
2262    when processing *.PL files. [Reported by Jaap Karssenberg]
2263
2264  - We now only attempt to fix the shebang line on a script if the
2265    shebang line matches the regex /perl/i .  This fixes some instances
2266    where people put shell scripts in their distributions. [Jaap
2267    Karssenberg]
2268
2269  - We no longer generate a 'requires', 'recommends', 'conflicts',
2270    etc. entry in the META.yml file if there's no data to go in it.
2271
2272  - Added a documentation reference to Michael Schwern's wiki for tips
2273    on conversion from MakeMaker to M::B. [Randy Sims]
2274
2275  - If there are script_files, we now add EXE_FILES to the
2276    'traditional' Makefile.PL generated by M::B::Compat. [Suggested by
2277    Yuval Kogman]
2278
2279  - Documented the 'test_files' parameter to new(). [Reported by Tony
2280    Bowden]
2281
2282  - Fixed a problem in "Build help <action>", which didn't find the
2283    correct help chunk if <action> was the final element in a POD
2284    list. [Jaap Karssenberg]
2285
2286  - Fixed a problem in the get_action_docs() method which gave
2287    incorrect results if the method was called more than once in the
2288    same program.
2289
2290  - Fixed a problem in which actions defined by user subclasses
2291    wouldn't be available via the pass-through Makefiles created by
2292    Module::Build::Compat. [Reported by Jaap Karssenberg]
2293
2294  - We now use Data::Dumper instead of our own ad-hoc serialization
2295    routines to create the 'traditional' Makefile.PL
2296    arguments. [Suggested by Yuval Kojman]
2297
2298 0.22  Sat Jan 10 22:05:39 CST 2004
2299
2300  - On Unixish platforms, the syntax "FOO=BAR /bin/baz arg arg" now
2301    works when present in $Config{ld}.  This solves a problem on Mac OS
2302    X 10.3. [Reported by Adam Foxson]
2303
2304  - The have_c_compiler() now also tests whether the linker seems to
2305    work too.
2306
2307  - Fixed a problem with creating the distribution tarball in which
2308    permissions would usually be all read-only.  We now use our own
2309    file-copying routines rather than those in ExtUtils::Manifest,
2310    because those do some annoying extra permissions-setting stuff for
2311    no apparent reason.  It makes me happy that this was a very very
2312    easy patch to make.  [Reported by Thomas Klausner]
2313
2314  - The compile_c() method now includes $Config{cccdlflags} in its
2315    command invocation.  It's usually empty, but not always, so we
2316    didn't notice for a while. [Richard Clamp]
2317
2318  - On some platforms it's common to have a $Config{make} defined, but
2319    no 'make' utility actually available.  We now detect this and skip
2320    some 'make' compatibility tests. [Randy Sims]
2321
2322  - Fixed a spurious testing failure on non-Unix platforms that
2323    happened because we accidentally call localize_file_path() on empty
2324    strings in the test suite. [Spotted by Randy Sims on Windows]
2325
2326  - Made the 'name', 'abstract', 'author', and 'version' properties
2327    required when building a PPD file. [Spotted by Randy Sims, Dave
2328    Rolsky, & Glenn Linderman]
2329
2330  - When building a 'traditional' Makefile.PL with
2331    Module::Build::Compat, we now use 'VERSION_FROM' when possible,
2332    rather than always using 'VERSION'.  This way the Makefile.PL
2333    doesn't have to get modified every release.
2334
2335  - Made some fixups to the 'PPM' info-file, improving compatibility
2336    with ActiveState's PPM tools. [Randy Sims, Glenn Linderman]
2337
2338  - The 'dist_author' property can now accept multiple authors, see the
2339    docs for more info. [Randy Sims]
2340
2341  - If the user doesn't have YAML.pm installed during ACTION_dist, we
2342    now create a minimal YAML.pm anyway, without any dependency
2343    information.
2344
2345  - The 'distribution_type' field is no longer created in META.yml
2346    files, in accordance with the finding made at the London CLPAN
2347    meeting that it's essentially meaningless and ill-defined.
2348
2349  - The 'dist' action now accepts an optional 'tar' parameter to use a
2350    system utility for building the tarball, and a 'gzip' parameter for
2351    compressing it.  If these are used, Archive::Tar won't be invoked.
2352    This was added because Archive::Tar is producing some very
2353    non-cross-platform tarballs that many tar utilities can't handle.
2354
2355  - During testing, if YAML.pm isn't installed, then we won't try
2356    making a tarball either, since this would invoke YAML to create the
2357    META.yml file.
2358
2359  - Fixed a problem with chmod() being called incorrectly on MacOS
2360    (i.e. MacPerl, not Mac OS X).  [Spotted by Paul Sanford Toney]
2361
2362  - Fixed a problem with the --config flag not being treated properly
2363    (essentially ignored) on the command line for 'perl Build.PL' or
2364    'Build <action>'. [Spotted by Jakub Bogusz]
2365
2366  - Added a new config() method to get at the Build object's notion of
2367    the %Config hash.
2368
2369  - Test::Harness is starting to contend for the Most Crotchety Module
2370    Award.  Work around a few of its nits when setting harness
2371    switches. [Spotted by Diab Jerius]
2372
2373  - Now the Build script will die() if we're run from the wrong
2374    directory, rather than trying to chdir() to what it thinks is the
2375    right directory and do its work there.  See
2376    https://rt.cpan.org/Ticket/Display.html?id=4039 . [Chris Dolan]
2377
2378  - Changed the manpage separator on OS/2 to '.'. [Ilya Zakharevich]
2379
2380  - On OS/2, disable C compilation, since apparently it isn't working
2381    there. [Reported by Ilya Zakharevich]
2382
2383  - Inserted a comment into auto-generated Makefile.PLs saying it was
2384    auto-generated. [Randy Sims]
2385
2386  - Fixed some annoying behavior in generated passthrough Makefile.PLs
2387    when the user chose not to install Module::Build, or if
2388    installation failed. [Reported by Ilya Zakharevich and Richard
2389    Clamp]
2390
2391  - Moved the documentation for 'codebase' to the section where it's
2392    relevant. [Randy Sims, Glenn Linderman]
2393
2394  - Fixed a have_c_compiler() failure on some platforms, we now define
2395    a boot_compilet() function (since we're compiling a library, not an
2396    executable). [Randy Sims]
2397
2398  - Added a recipe to the Module::Build::Cookbook describing how to
2399    maintain compatibility with older versions of CPAN.pm [Jim Cromie]
2400
2401  - Removed caveat about "looking for alternatives" in how hashes are
2402    specified on the command line, since an alternative has been found.
2403
2404  - Previously most warnings about optional prerequisites looked like
2405    they were actually error messages about required prerequisites.
2406    This has been corrected. [Reported again by Sagar Shah]
2407
2408  - Added support for building XS (and C in general) stuff on AIX.
2409    This was done by a small reorganization of prelink_c() method from
2410    Windows.pm to Build.pm, and it is only invoked for the platforms
2411    that need it invoked.  AIX also massages some very naughty bits
2412    (MakeMaker macro variables) in $Config{lddlflags} that should never
2413    have been put there, but alas, they're there, so we find & resolve
2414    them.
2415
2416  - Added OS/2 ($^O = 'os2') to the list of Unix-like platforms.  This
2417    basically means that most platform-specific operations will be done
2418    in a Unix-like manner.
2419
2420  - Pass-through Makefiles will now die() when they're given a PREFIX
2421    parameter, and suggest using 'destdir' or 'install_base' instead.
2422    Previously they just ignored the parameter and tried to install to
2423    the default location, which is clearly not what the user wanted.
2424
2425  - Updated my email address in the documentation to a more recent
2426    variant.
2427
2428  - Add NetBSD to the list of Unix-like systems. [Adrian Bunk]
2429
2430  - Add SVR5 to the list of Unix-like systems. [Rafael Garcia-Suarez]
2431
2432  - We now use Pod::Parser to find the ABSTRACT and AUTHOR when it's
2433    available on the system. [initial patch by Randy Sims]
2434
2435  - Fixed a little scalar/list buglet in a documentation example.
2436
2437 0.21  Wed Oct 15 20:47:05 CDT 2003
2438
2439  - Added a have_c_compiler() method.
2440
2441  - Added documentation for the requires(), recommends(),
2442    build_requires(), and conflicts() methods.
2443
2444  - On Unix platforms, we now create the "Build" script with a #! line
2445    matching the perl interpreter that was used to invoke the Build.PL
2446    script, rather than whatever is in $Config{startperl}.  This avoids
2447    a potential warning about the interpreters not matching. [Spotted
2448    by Ken Y. Clark]
2449
2450  - The Unix version now uses the safer multi-argument form of system()
2451    when building distribution tarballs.
2452
2453  - Added a regression test for the 'dist' action to the t/runthrough.t
2454    test.
2455
2456  - Fixed a problem with File::Spec usage when creating the names of
2457    'libdoc' manual pages - the code wasn't dealing with the volume or
2458    file portions correctly on certain platforms.
2459
2460  - When creating the names of the 'libdoc' manual pages, we no longer
2461    assume that pods are under the hard-coded paths 'blib/lib' or
2462    'blib/arch'.
2463
2464  - Fixed a crashing bug that could sometimes occur when the
2465    distribution contained no 'lib' directory. [Chris Dolan]
2466
2467  - Fixed a crashing bug that happened when the user had .PL files in
2468    the lib/ directory and didn't explicitly name them in a hash
2469    reference to the new() constructor. [Chris Reinhardt, bug #4036]
2470
2471  - .PL files are now passed the names of their target file(s) on the
2472    command line when they run.
2473
2474  - When YAML.pm wasn't installed, t/runthrough.t wasn't properly
2475    skipping some tests that required YAML.  This is now fixed.
2476    [Stephen J. Smith]
2477
2478  - Added documentation for the dist_version() and dist_name()
2479    methods. [Spotted by Johan Vromans]
2480
2481  - Existing values in $ENV{HARNESS_PERL_SWITCHES} are now respected
2482    and not squashed when we run the 'test' action. [Paul Johnson]
2483
2484  - On cygwin, the separator string for manual page names has been set
2485    to '.'.  Previously it was '::', inherited from Unix. [Yitzchak
2486    Scott-Thoennes]
2487
2488  - Avoid a warning when Build.PL is run (i.e. when the new() method is
2489    called) and no MANIFEST file exists. [Michael Schwern and Kevin
2490    Ruscoe]
2491
2492  - Added documentation for the 'code' and 'docs' actions. [Steve
2493    Purkis and Mark Stosberg]
2494
2495  - The internal method compile_support_files() has been renamed to
2496    process_support_files() in order to make it consistent with other
2497    processing methods.  Note that it was never documented using the
2498    old name.  It's still not documented, actually.  Maybe later.
2499
2500  - Skip the 'write' pseudo-entry in the 'diff' action's installation
2501    map. [Chris Dolan]
2502
2503  - Fixed a bug in which notes() set in the Build.PL before
2504    create_build_script() was called would get lost unless more notes()
2505    were also set afterwards. [Spotted by Dave Rolsky]
2506
2507  - The process of building elements of the distribution is now driven
2508    by a list of build elements, paving the way for letting people add
2509    their own types of build elements in future versions of
2510    Module::Build (or in the current version with some difficulty).
2511
2512  - Fixed some linking errors on Cygwin. [Randy Sims, Terrence Brannon]
2513
2514  - Fixed a line-ending problem with detecting the dist_abstract
2515    properly on Cygwin. [Randy Sims]
2516
2517  - Fixed a problem with signatures that occurred if 'distsign' was
2518    called before 'distdir' - the signature would be generated twice.
2519
2520  - Added a 'create_readme' parameter to new(), which will use
2521    Pod::Text to generate a README from the main (dist_version_from)
2522    module file during the 'distdir' action.
2523
2524  - We now refuse to run the 'Build' script if it was created using a
2525    different version of Module::Build.  This has caused a couple of
2526    nasty bugs in the past, I don't want to know what it would cause in
2527    the future.
2528
2529  - Documentation for do_system() has been added. [Dave Rolsky]
2530
2531  - run_perl_script() is now available as a class method, though it
2532    will need to (re-)find the perl interpreter in this case.
2533
2534  - Added a new_from_context() method that authors of automated tools
2535    like CPANPLUS and CPAN can use instead of running all tasks as
2536    sub-processes.  We also use it in the regression tests for
2537    Module::Build itself.  ** Note that this method is currently
2538    undocumented because its name may change in the future. **
2539
2540  - When signing distributions with Module::Signature, we now
2541    automatically add the SIGNATURE file to the MANIFEST, avoiding an
2542    unpleasant chicken/egg problem for the module author.
2543    [unpleasantness spotted by sungo]
2544
2545  - In Module::Build::Compat, added support for the 'verbose' parameter
2546    to Makefile.PL [spotted by Soren Andersen, fixed by Michael
2547    Schwern]
2548
2549  - The Module::Build distribution now has a cryptographic 'SIGNATURE'
2550    file created by Module::Signature.
2551
2552  - Added proper documentation for the subclass() method. [spotted by
2553    Jonathan Steinert]
2554
2555  - Worked around a Config.pm bug in Red Hat 9 which prevented man
2556    pages from being installed in the correct places. [spotted by Ville
2557    Skytta]
2558
2559  - Fixed a Module::Build::Compat bug in which setting INSTALLDIRS
2560    caused a crash. [spotted by Ilya Martynov]
2561
2562 0.20  Tue Aug 26 14:34:07 CDT 2003
2563
2564  - Separated the 'build' action into two separate actions, 'code' and
2565    'docs'.  This is similar to MakeMaker's separation of the 'all'
2566    target into 'pure_all' and 'manifypods'.  This fixes a permissions
2567    hassle in which doing 'sudo Build install' would often create local
2568    doc files that needed superuser permissions to delete.
2569
2570  - Enhanced the 'help' action - 'Build help foo' will now show the POD
2571    documentation for the 'foo' action.
2572
2573  - Added a notes() feature, which helps share data transparently
2574    between the Build.PL and t/*.t scripts.
2575
2576  - The installation process will now create man(1) and man(3) pages
2577    from POD in modules & scripts, and install them.  We don't build
2578    man pages when there's nowhere to install them, such as on some
2579    Win32 or most Mac systems.  [large patch by Steve Purkis, 5.005 fix
2580    by Mathieu Arnold]
2581
2582  - The 'distdir' action now copies files to the distribution
2583    directory, rather than making them hard links to the original
2584    files.  This allows authors to do last-minute alterations of the
2585    files without affecting the originals. [Dave Rolsky]
2586
2587  - If the author uses XS files in nonstandard locations, the copied
2588    versions of those files will now be cleaned up properly.
2589
2590  - In invoking the 'test' action or invoking 'xsubpp', we now use the
2591    same perl executable as we use everywhere else, rather than blindly
2592    using $^X or $Config{perlpath} (neither of which are very
2593    reliable).
2594
2595  - Fixed a problem with the 'install_path' parameter given to
2596    'Build.PL' being lost in subsequent actions. [Reported by Mathieu
2597    Arnold]
2598
2599  - Fixed yet another bug with installation directories, in which the
2600    'install_base' parameter wasn't being respected on the command
2601    line.  [Spotted by Jonathan Swartz]
2602
2603  - Changed the way the depends_on() method works inside action
2604    subroutines - now each action will only run once per dispatch()
2605    invocation (similar to how perl's require() function works).  This
2606    helps avoid some difficult problems with dependency loops.
2607
2608  - Changed the documentation for the 'autosplit' parameter to give
2609    reasons why it may not be a good idea to use, but no longer
2610    threaten to remove it.  [Suggested by Martyn J. Pearce]
2611
2612  - Improved the formatting of the 'traditional' Makefile.PL generated
2613    by Module::Build::Compat->create_makefile_pl. [Michael Schwern]
2614
2615  - The 'traditional' Makefile.PL will now use the 'module_name'
2616    parameter (as NAME) if it's available, otherwise it will continue
2617    to use the 'dist_name' (as DISTNAME). [Michael Schwern]
2618
2619  - Created read/write accessor methods for all our 'properties'.
2620    [Michael Schwern]
2621
2622  - The 'test_files' parameter can now be specified using glob() syntax
2623    (i.e. 't/*.t'), and the corresponding test_files() method is now a
2624    read/write accessor.
2625
2626  - The location of the 'blib' directory is now a property of the Build
2627    object - nobody is likely to notice this change, with any luck, but
2628    it makes the design and code cleaner.
2629
2630  - The 'disttest' and 'distsign' methods now chdir() back to the
2631    directory where they started, rather than to the base_dir of the
2632    build.
2633
2634  - Improved comparisons of version strings containing underscore
2635    characters (indicating "beta" status). [Steve Purkis]
2636
2637  - Added documentation for the 'dist_author', 'dist_abstract', and
2638    'codebase' parameters to new(), and for the 'ppd' action. [Dave
2639    Rolsky]
2640
2641  - Added documentation for the up_to_date() and contains_pod()
2642    methods. [Dave Rolsky]
2643
2644  - 'traditional' pass-through Makefile.PLs will now contain an
2645    INSTALLDIRS parameter matching the Build.PL's 'installdirs'
2646    setting.
2647
2648  - version_from_file() now ignores $VERSION variables that are defined
2649    in POD or comments.  It can still be tricked by $VERSIONs in string
2650    literals, though.  [Steve Purkis]
2651
2652  - The code to find packages in module files now uses Steve's scanning
2653    method (above) to skip package-declaration-lookalikes in POD or
2654    comments.
2655
2656  - The 'disttest' action will now propagate its @INC settings to its
2657    subprocesses.
2658
2659 0.19  Wed Jul  9 22:34:02 CDT 2003
2660
2661  - Added support for the 'install_path' parameter, which allows custom
2662    specification of where things should be installed.  This is a major
2663    improvement to Module::Build's functionality.
2664
2665  - Added the 'install_base' parameter.  Provides an easy way to
2666    install to local or alternative directory trees.
2667
2668  - We now install scripts by default to $Config{installsitebin}
2669    instead of $Config{installscript}.  Neither is a great choice, but
2670    the former is likely to be [analogous to] /usr/local/bin, and the
2671    latter is likely to be [something like] /usr/bin .  If/when there's
2672    a $Config{installsitescript}, we'll start using that automatically.
2673
2674  - Fixed a problem on Win32 in which C and XS files wouldn't be
2675    compiled properly, and the user would see an error about 'Can't
2676    locate object method "format_compiler_cmd"'.
2677    (http://rt.cpan.org/Ticket/Display.html?id=2391)
2678
2679  - We now use the correct perl interpreter (via
2680    Module::Build->find_perl_interpreter) in pass-through makefiles.
2681
2682  - The t/compat.t test now uses $Config{make} instead of just 'make'
2683    to test makefile compatibility.  This fixes some failures on Win32.
2684    We also skip this test entirely if no make utility is available.
2685
2686  - Alternative distribution layouts are now supported via the
2687    'pm_files', 'pod_files', 'xs_files', 'PL_files', and 'script_files'
2688    parameters to new().  This should help people transition from
2689    MakeMaker, and might even help us write an automatic transition
2690    tool.
2691
2692  - Added tests to t/runthrough.t that check to see installation is
2693    happening correctly.
2694
2695  - Added experimental code to build a .ppd file, in support of
2696    ActiveState's "Perl Package Manager". [original patch by Dave
2697    Rolsky]
2698
2699  - For authors who use Module::Signature to sign their distributions,
2700    we now create the SIGNATURE file right in the distribution
2701    directory, rather than creating it in the top-level directory and
2702    copying it into place.  This solves problems related to having
2703    files get out of date with respect to their signatures.
2704
2705  - We now don't depend on Module::Info to scan for packages during the
2706    'dist' action anymore, because it's way too aggressive about
2707    loading other modules that you may not want loaded.  We now just
2708    (ick, yuck) scan the .pm files with a regular expression to find
2709    "package Foo::Bar;" statements.
2710
2711  - Silenced some annoying copyright/logo output from Microsoft 'nmake'
2712    during Makefile compatibility testing. [Randy W. Sims]
2713
2714  - Command-line arguments may now either be specified using the syntax
2715    '--foo foovalue' as well as the traditional syntax 'foo=foovalue'.
2716    The former is often more convenient for shell tab-completion when
2717    the value is a filename (as in 'Build test --test_files t/basic.t').
2718
2719  - Command-line arguments may now include non-named parameters, which
2720    make some actions more natural.  For instance, the 'diff' action
2721    may now be invoked as 'Build diff -u' rather than as
2722    'Build diff flags=-u'.
2723
2724  - Pass-through Makefile.PLs now convert unknown Makefile.PL
2725    parameters to lower-case and hand them to Build.PL, rather than
2726    ignoring them.  This means we only have to account for the
2727    differences in the interface, not the entire interface, in
2728    translating parameters.
2729
2730  - We now issue a warning & don't proceed if asked to make a distdir
2731    and there's no MANIFEST or it's empty.
2732
2733  - Moved INSTALL to INSTALL.txt to increase compatibility with various
2734    odd versions of 'make' during 'make install' on case-insensitive
2735    filesystems (like nmake on Win32, often).  Only affects the
2736    Makefile compatibility layer.  [reported by Andrew Savige]
2737
2738  - Module::Build->known_actions() now works as a class method.
2739
2740  - Pass-through makefiles now list each action individually rather
2741    than using a ".DEFAULT" catch-all.  This improves compatibility
2742    with 'nmake' on Win32, and probably some other less common 'make'
2743    dialects.  [Andrew Savige]
2744
2745  - We're now more aggressive about testing the pass-through makefiles,
2746    e.g. making sure they can run 'all' and 'test' targets, and making
2747    sure the Makefile itself actually exists.
2748
2749  - Fixed a problem with check_installed_status() when installed
2750    version contains non-numeric characters like underscores.
2751
2752  - Fixed a problem with a bareword 'File::Spec' in one of the test
2753    scripts that caused it not to compile under 5.8.0 (but is fine
2754    under 5.6).
2755
2756  - Fixed a problem with the 'destdir' installation parameter on
2757    platforms that have volume identifiers in path names (like "C:" on
2758    Win32).  The identifier is now stripped from installation
2759    directories before prepending the destdir path.  The destdir path
2760    may still have a volume identifier on it.
2761
2762  - Added an 'add_to_cleanup' parameter to new() that calls
2763    add_to_cleanup() immediately for the given files.
2764
2765  - The distribution directory (e.g. Sample-Module-0.13/ ) will now be
2766    deleted during the 'clean' or 'realclean' actions.
2767
2768  - During testing of modules, blib/lib and blib/arch are now added as
2769    absolute paths, not relative.  This helps tests that load the
2770    modules at runtime and may change the current working directory
2771    (like Module::Build itself does during testing).
2772
2773  - The $Config{cc} entry on some people's systems is something like
2774    'ccache gcc', so we now split that string using split_like_shell().
2775    [Richard Clamp]
2776
2777  - Added documentation for 'extra_linker_flags' parameter, and added a
2778    corresponding 'extra_compiler_flags' parameter. [original patch by
2779    Richard Clamp]
2780
2781  - The pass-through Makefile created by Module::Build::Compat now
2782    supports MakeMaker options like POLLUTE=1 and INC.  We also just
2783    warn & skip when we see any unknown MM parameters, rather than
2784    dying.  [Dave Rolsky]
2785
2786  - Fixed an error about how @INC and $ENV{PERL5LIB} interact during
2787    the testing of M::B itself. [jk <billy2000@fastmail.fm>]
2788
2789  - The pass-through Makefile doesn't include 'recommended' M::B
2790    dependencies in the Makefile anymore, since they're not strictly
2791    necessary.  In particular, this makes installing M::B itself
2792    easier.
2793
2794  - A new 'create_makefile_pl' parameter lets you use
2795    Module::Build::Compat during the 'distdir' (or 'dist') action to
2796    automatically create a Makefile.PL for compatibility with
2797    ExtUtils::MakeMaker.  The parameter's value should be one of the
2798    styles named in the Module::Build::Compat documentation.
2799
2800  - When compiling C code, we now respect 'pollute' and 'inc'
2801    parameters. (XXX - needs docs) [Dave Rolsky]
2802
2803  - Made the creation of the "install map" more generic.  (XXX - needs
2804    documentation)
2805
2806  - Fixed a problem in which add_to_cleanup() didn't note cleanup files
2807    unless create_build_script() had been called already. [Dave Rolsky]
2808
2809  - During 'Build dist', we no longer have to load each .pm file (via
2810    Module::Info) to determine the $VERSION numbers inside.  Instead,
2811    we call our internal version_from_file() method, which is the same
2812    thing MakeMaker and PAUSE and search.cpan.org do.  Also fixes a
2813    failure when Module::Info is installed in a nonstandard directory.
2814    [reported by Teun Burgers]
2815
2816  - Fixed some failing test code on Windows - open files can't be
2817    deleted. [Andrew Savige]
2818
2819  - The Cygwin platform is now treated as a flavor of Unix rather than
2820    a flavor of Windows. [chocolateboy]
2821
2822  - We're now more aggressive about adding temporary C compilation
2823    files (*.c, *.bs) to the cleanup list. [Dave Rolsky]
2824
2825  - When constructing the list in META.yml of packages provided by this
2826    distribution, we now use the same rules as the PAUSE scanner does
2827    when a single .pm file contains multiple VERSIONs.  [Andreas Koenig]
2828
2829  - check_installed_status() now works as both a class method and an
2830    object method (and is documented so).  [Spotted by Dave Rolsky]
2831
2832 0.18  Tue Apr  8 13:24:23 CDT 2003
2833
2834  - We now rewrite the shebang lines of scripts ourselves, rather than
2835    relying on MakeMaker routines to do it.  MakeMaker changed the way
2836    this happened (not the result, but where the code lived) a few
2837    times.  [Suggested by Richard Clamp]
2838
2839  - The scripts() method has changed to script_files(), and likewise
2840    the 'scripts' parameter has changed to 'script_files'.  The old
2841    names can still be used for backward compatibility.
2842
2843  - Support for the 'scripts' parameter (which is now 'script_files')
2844    was broken in 0.17, now it's fixed.  [Richard Clamp]
2845
2846  - We now recommend ExtUtils::ParseXS 2.02, which will fail to load
2847    with perl 5.005 or earlier (which is proper, because it doesn't
2848    work with those versions).  When it fails to load, we still fall
2849    back to using the xsubpp script for XS parsing. [spotted by Dave
2850    Rolsky, fix suggested by Richard Clamp]
2851
2852  - Now works on VMS - the Build script's shebang-line-equivalent
2853    wasn't being formed correctly there - though just about everything
2854    else worked fine.  [Tested & patched by Michael Schwern]
2855
2856  - Eliminated a warning that occurred if 'perl Build.PL' or the
2857    check_installed_status() method was run with -w.  [Spotted by
2858    Michael Schwern]
2859
2860 0.17  Sat Mar 29 18:06:01 CST 2003
2861
2862  - Now works under perl 5.005_03.  [Richard Clamp]
2863
2864  - When building blib/ , .PL files are now processed before doing
2865    anything else.  This means .PL files can be used in any of the
2866    other contexts.
2867
2868  - The locating and processing of .pm, .pod, .xs, .PL files and script
2869    files are now isolated into their own methods.  This is aimed
2870    toward providing a stable interface for this stuff, so they can be
2871    overridden, parameterized, etc.  They're not quite stable yet,
2872    though.
2873
2874  - The internal lib_to_blib() method has gone away, because processing
2875    is now done by smaller specialized methods.  This method had some
2876    duplicate assumptions about filenames that it's nice to get rid of.
2877
2878  - .PL files are no longer automatically processed in the c_source
2879    directory, they must be specified manually in a 'PL_files'
2880    parameter.
2881
2882  - Mention in the docs that it's useful to do "PL_FILES => {}" in a
2883    Makefile.PL if you're using both a Makefile.PL and a
2884    Build.PL. [Dom]
2885
2886  - Add several options to the 'license' field, so that we're in better
2887    sync with PAUSE and CPAN options. [Andreas Koenig]
2888
2889  - Created a find_perl_interpreter() method that tries to locate the
2890    currently executing perl interpreter.  Following a suggestion from
2891    Nicholas Clark <nick@ccl4.org> for Inline, we prefer an absolute
2892    path in $^X, then an existent path in $Config{perlpath}, then
2893    whatever's in $^X.
2894
2895  - Use the aforementioned perl to run scripts in run_perl_script().
2896    This fixes the spurious warning "WARNING: Configuration was
2897    initially created with 'foo', but we are now using 'bar'" that
2898    appeared a lot in version 0.16.
2899
2900
2901 0.16  Mon Feb 24 13:06:47 CST 2003
2902
2903  - All three C compilers that perl supports on Windows environments
2904    (MSVC, BCC, and GCC) are now supported by Module::Build.  We now
2905    reportedly pass all tests on Windows.  [Randy W. Sims]
2906
2907  - The test t/xs.t, which tests building of XS modules, will be
2908    skipped if no C compiler is found. [suggested by Randy W. Sims]
2909
2910  - The "install" action accepts new "destdir" [motivated by Michael
2911    Schwern and Chip Salzenberg] and "uninst" parameters [by Dave
2912    Rolsky].  The former prepends an arbitrary directory to all
2913    installation paths (useful for package management), and the latter
2914    will tell ExtUtils::Install to remove any differing files that are
2915    "shadowing" the stuff you're installing from a different location,
2916    just like MakeMaker's "make install UNINST=1" command will do.
2917
2918  - Made changes to the generated Makefile in Module::Build::Compat
2919    that much better support Windows platforms [after suggestions by
2920    James Freeman]
2921
2922  - Added experimental support for creating distribution SIGNATURE
2923    files via Module::Signature. [Dave Rolsky]
2924
2925  - Added experimental support for installing via the "only.pm" module,
2926    which allows loading specific versions of modules.  Since this
2927    module is so new, the interface may still be changing. [Brian
2928    Ingerson]
2929
2930  - Added support for installing executable scripts, via the 'scripts'
2931    parameter to new(), and the scripts() accessor method.
2932
2933  - Fix an infinite loop that occurred when doing 'perl Build.PL
2934    config="foo=bar"'
2935
2936  - Fix up the formatting of the error message the user gets when
2937    prereqs aren't satisfied.
2938
2939 0.15  Fri Jan 17 15:00:24 CST 2003
2940
2941  - In link_c(), extra object files were mistakenly being treated as
2942    output files, not input files, in the up-to-date check.  Fixed.
2943
2944  - In up_to_date(), don't make an unnecessary copy of the file lists
2945    when they're specified as array references.
2946
2947  - Split off the C compilation phase into its own method,
2948    compile_support_files(), for easier subclassing.
2949
2950  - Start a stub of a 'manifypods' action.
2951
2952  - Compiler optimizations weren't being included in C compilation
2953    statements.  Fixed.
2954
2955  - The 'extra_linker_flags' parameter wasn't being honored.  Fixed.
2956
2957  - The 'ccflags' Config.pm entry wasn't being properly split into
2958    separate arguments.  Fixed.
2959
2960
2961 0.14  Fri Dec 13 14:06:29 AEST 2002
2962
2963   - Added support for MacPerl (Mac OS version 9 and below), which (as
2964     far as I know) was never natively supported by MakeMaker.  Still
2965     lacks support for the 'test' action (because Test::Harness
2966     requires forking, which MacPerl won't do) and compiling XS/C files
2967     (because I don't know how to invoke a compiler on MacOS, and one
2968     may not even be available).  This change is brought to you by
2969     Michael Schwern and the letter '('.
2970
2971   - Improved processing of .xs files.  Now we use the new
2972     ExtUtils::ParseXS module if it's available, otherwise we use
2973     backticks and write the result to a .c file ourselves.  This
2974     avoids the need to do cross-platform shell redirection.
2975
2976   - Make sure all parts of 'Build test' use the not-yet-installed
2977     version of Module::Build.  This only affects the tests for this
2978     module, not any of the module code itself.  [Spotted by Schwern]
2979
2980   - Oopsie - use $Config{ld} instead of $Config{cc} for linking.
2981
2982   - Added a 'diff' action, which is useful for comparing the details
2983     of what you're about to install with what is already installed on
2984     your system.  This uses File::Compare, which is in the core.
2985
2986   - Fixed a problem on Windows in which the _build/ directory wasn't
2987     getting deleted during the 'realclean' action, because we had a
2988     file open in that directory. [Spotted by Michael Schwern]
2989
2990   - delete_filetree() now always uses File::Path::rmtree(), regardless
2991     of whether the thing being deleted is a file or a directory.  This
2992     helps remove things on obscure platforms with strange locking
2993     rules (or even not so obscure ones like MacOS).  It also now
2994     reports the number of files or directories deleted (without
2995     recursing directory contents).
2996
2997   - rm_previous_build_script() is gone, replaced by calls to
2998     delete_filetree().
2999
3000   - 'Build' now chdir()s in a BEGIN block, so the 'use Module::Build'
3001     statement will work correctly.  Solves a problem on MacOS, where
3002     the 'Build' script may often be invoked from the wrong working
3003     directory.  [Fix by Michael Schwern]
3004
3005   - Internally we now use the multi-argument form of system() to run
3006     external commands (such as 'diff' or 'cc') whenever possible (and
3007     whenever we can't avoid system() altogether).  Note that this
3008     means we have to handle splitting some strings (such as
3009     $Config{ccflags}) into argument lists like the shell would, which
3010     is a drag.  However, the alternative would be to handle shell
3011     quoting of all arguments to commands ourselves, which is an even
3012     bigger drag across platforms and involves arbitrary filenames and
3013     so on.
3014
3015   - To handle the argument splitting mentioned above, a method
3016     split_like_shell() has been created.  So far it's just doing naive
3017     processing.  In practice, I've yet to actually see a %Config entry
3018     that uses quotes & spaces, so the splitting task is usually not
3019     very error-prone.
3020
3021   - The 'test' action now takes a 'test_files' parameter, similar to
3022     the (undocumented) ExtUtils::MakeMaker TEST_FILES argument.  Handy
3023     during development when fixing bugs.
3024
3025   - Internally, the rscan_dir() method can now accept a predicate
3026     function that decides whether a file/directory should be matched.
3027
3028   - We now issue a warning message when the author hasn't specified a
3029     license type.
3030
3031 0.13  Wed Nov 20 20:07:53 AEST 2002
3032
3033   - 'cleanup' file lists are now written immediately, rather than at
3034     program termination.  This helps avoid "phantom files" that don't
3035     get handled by the 'realclean' action.  The internal
3036     write_cleanup() method (which was never documented) is now gone.
3037
3038   - The 'blib/' directory is now properly cleaned up in more (all?)
3039     circumstances.  Previously it could become a phantom if
3040     create_build_script() was never called.
3041
3042   - Now scan the 'c_source' directory for .cpp (C++) files as well as
3043     .c files, and compiles them.
3044
3045   - Use a 'phony' target for 'make manifest' in the pass-through
3046     Makefile, for the same reason as 'make install' (see version 0.12
3047     notes below).
3048
3049   - Module::Build::Compat now accepts any known Config.pm key and
3050     passes it through to the Build.PL.  Fixes a problem with CPANPLUS,
3051     which was passing INSTALLMAN1DIR.
3052
3053   - The file 'META.yaml' has been re-named to 'META.yml' in order to
3054     cooperate better with systems that can only handle 3 characters
3055     after the dot.
3056
3057   - The t/xs.t test should give more informative error messages upon
3058     failure.
3059
3060 0.12  Thu Nov 14 18:31:47 AEST 2002
3061
3062   - The META.yaml file was erroneously looking for 'build_depends'
3063     instead of 'build_requires'. [spotted by Iain Truskett]
3064
3065   - Add prompt() and y_n() methods for use in Build.PLs
3066
3067   - Do more to work with all versions of Test::Harness when setting
3068     the TEST_VERBOSE flag and running under the debugger [patch by
3069     Dave Rolsky]
3070
3071   - Include a test for verbosity handling
3072
3073   - Make sure the blib/ directory is always cleaned up with the
3074     'clean' or 'realclean' action.
3075
3076   - In a pass-through Makefile.PL, inform 'make' that 'install' is a
3077     "fake target", so that it works properly on case-insensitive
3078     filesystems like HFS+ with distributions that contain an INSTALL
3079     file. [patch by Brian Ingerson]
3080
3081   - In Module::Build::Compat, show an example Makefile.PL that can
3082     install Module::Build and re-invoke itself in one fell swoop [Dave
3083     Rolsky and Autrijus Tang]
3084
3085   - Improve the formatting of the Module::Build and
3086     Module::Build::Compat documentation.
3087
3088 0.11  Fri Aug 23 18:50:46 AEST 2002
3089
3090   - 'module_version' and 'module_version_from' have been replaced by
3091     'dist_version' and 'dist_version_from', which is what they really
3092     meant in the first place.  'dist_name' has been added.
3093
3094   - 'module_name' is now just a way to set 'dist_name' and
3095     'dist_version_from' in a convenient way.
3096
3097   - The 'name' in META.yaml is now the distribution name, not the
3098     (incorrect) module name. [spotted by Graham Barr]
3099
3100   - Added the check_installed_status() and prereq_failures() methods
3101     for checking prerequisite information with the programmatic
3102     interface
3103
3104   - check_installed_version() now uses check_installed_status()
3105     internally
3106
3107   - Documented the create_build_script() method, which had escaped
3108     documentation.
3109
3110   - create_build_script() now writes prerequisite information to the
3111     _build/ directory, for use by Module::Build::Compat.
3112
3113   - Module::Build::Compat has documentation for a safer way to write a
3114     dummy Makefile.PL. [patch by Autrijus Tang]
3115
3116 0.10  Wed Aug  7 19:36 2002
3117   - Recommend YAML 0.35 instead of 0.30.
3118
3119   - Don't die during 'Build disttest' if YAML isn't installed.  This
3120     fixes tests 5-10 in runthrough.t if YAML isn't installed.
3121
3122   - Die if an unknown license type is used, but still default to
3123     'unknown' if no license is specified.
3124
3125   - Use YAML::DumpFile() if we're using a recent YAML,
3126     YAML::StoreFile() otherwise.
3127
3128   - Show specific error messages in runthrough.t.
3129
3130   - Add a generated_by entry to the META.yaml file.
3131
3132   - Skip a few tests if YAML isn't installed.
3133
3134 0.09  Fri Jun 28 11:07:08 EST 2002
3135
3136   - The 'distdir' action wasn't deleting the distribution directory
3137     before building it again.  This meant that, say, if you did 'Build
3138     disttest' then 'Build dist', you'd end up with a blib/ directory
3139     in your distribution.  I actually had this happen for version
3140     0.08, and it's not nice to distribute a blib/ on CPAN.
3141
3142   - We now keep track of the 'base_dir', i.e. the top-level build
3143     directory, so we can change back into it if we change out of it.
3144     This necessitated a cwd() method, which uses the Cwd.pm module.
3145     I'm aware of Cwd's limitations, particularly under taint-mode, but
3146     I don't know a way around using it here.
3147
3148   - The 'dist_dir' action now changes back into 'base_dir' directory.
3149
3150   - We now do write_config() inside the create_build_script() method,
3151     not inside the new() method.
3152
3153   - Simplified the find_version() method, and improved its error
3154     messages.
3155
3156   - Renamed module_name_to_file() to find_module_by_name(), and added
3157     a parameter specifying the directories to search in.  Previously
3158     we searched in 'lib' and @INC, which wasn't correct in all
3159     situations.
3160
3161   - Patched the docs to change "Build test" to "./Build test"
3162     [Elizabeth Mattijsen]
3163
3164 0.08  Wed Jun 26 20:30:56 EST 2002
3165
3166   - Fixed the 'prereq' alias for the 'requires' parameter
3167
3168   - Added some tests in t/basic.t to test the dependency checking
3169
3170   - Added 'artistic' as a licensing option [Arthur Bergman]
3171
3172   - Fixed some bugs in requires/prereq/recommends/conflicts/build_depends
3173
3174   - Fixed a typo in the 'distclean' action that prevented its
3175     execution [Arthur Bergman]
3176
3177   - Separated the linking phase of building XS items into its own
3178     link_c() method.  Its interface is still unstable, so it's not
3179     documented yet. [suggested by Arthur Bergman]
3180
3181 0.07  Jun  9 2002 15:46
3182
3183   - We now generate a 'META.yaml' metadata file during 'Build dist'.
3184     This can be very useful for lots of things, none of which are
3185     implemented yet.
3186
3187   - Added a 'dynamic_config' parameter, defaulting to false.  This
3188     lets distribution systems (CPAN.pm, etc.) build, test, and install
3189     "easy" modules without having to execute the Build.PL at runtime.
3190     It's also a guarantee that the list of dependencies is exactly
3191     what is present in the metadata file, and won't be changed during
3192     the build process.
3193
3194   - Added support for "recommended" and "build-time requirement"
3195     modules, besides those that are absolutely required.  Also added a
3196     "conflicts" field.
3197
3198   - Changed the 'prereq' field to 'requires' (the old name will
3199     continue to work).
3200
3201   - Added support for checking the installed version of perl as an
3202     explicit dependency.
3203
3204   - Added a 'license' parameter to specify one of a fixed number of
3205     licenses for the distribution.
3206
3207   - Fixed a bug in Module::Build::Compat that was preventing arguments
3208     from being processed properly. [patch by Ilya Martynov]
3209
3210   - Make sure we're in the right directory when we write the cleanup
3211     file, since various ExtUtils::Install errors might leave us in an
3212     unknown directory. [patch by Ilya Martynov]
3213
3214   - Specified the 'license', 'recommends', and 'dynamic_config'
3215     values in Build.PL, and changed 'prereq' to 'requires'.
3216
3217 0.06  Apr 2 2002 17:44
3218
3219   - Added the Module::Build::Compat module for assisting and
3220     explaining compatibility with ExtUtils::Makemaker and cohorts.
3221
3222   - State is now saved using Data::Dumper instead of my ad-hoc
3223     mechanism, guaranteeing data integrity.  Whitespace values broke
3224     in the former scheme.
3225
3226   - Added the 'recommended' option, which works like 'prereq' but
3227     isn't insistent.
3228
3229   - Separated the various parameters into three groups: parameters
3230     that tell Module::Build what to do, Config.pm parameters, and
3231     user-defined parameters for each build (the module author is the
3232     'user' here).  This helps avoid conflicts between names, and it
3233     was silly to have them all together.  The three groups of
3234     parameters are subject to the same rules for overriding: values
3235     specified during a Build action take precedence over values
3236     specified at 'perl Build.PL' time, which in turn take precedence
3237     over values specified in the call to new().
3238
3239   - Improved support for .PL files.  Any .PL file in the lib/
3240     directory or the directory specified by 'c_source' will now get
3241     properly executed.  I also added a 'PL_files' parameter that you
3242     can use in case the .PL doesn't create an obviously-named output
3243     file.
3244
3245   - If a prerequisite condition is malformed, we now report a prereq
3246     failure and say why.  Previously we issued a warning and kept
3247     going.
3248
3249
3250 0.05   10-Jan-2002 20:26
3251   - Added the Module::Build->subclass() method, which makes it easier to
3252     make quick-and-dirty subclasses of Module::Build.
3253
3254   - Reorganized the docs a bit.
3255
3256   - Added the 'testdb' action, and the 'debugger=1' argument to the
3257     'test' action, both of which run tests under the perl
3258     debugger. (idea: Dave Rolsky)
3259
3260   - Added prerequisite checking (Dave Rolsky)
3261
3262   - Fixed an unlikely-to-occur bug with misquoted strings in the
3263     'Build' script (spot: Dave Rolsky)
3264
3265   - We're more careful about shush-ing warnings that
3266     ExtUtils::Manifest might emit (Dave Rolsky)
3267
3268   - The 'help' action now auto-generates the list of actions (Dave Rolsky)
3269
3270   - Added the 'distcheck', 'skipcheck', 'distclean', 'distdir', and
3271     'disttest' actions (Dave Rolsky)
3272
3273   - We're a little more aggressive about cleaning up temporary files -
3274     we'll try to clean them up even when we don't have write permission
3275     on them.  This isn't as dastardly as it sounds; if we /really/
3276     don't have permission, we won't be able to remove them no matter
3277     how hard we try.
3278
3279 0.04   Fri Nov 16 16:55 2001
3280   - Added a 'manifest' action.  It's just like MakeMaker's 'make manifest', it
3281     brings your MANIFEST file up to date with your distribution directory.
3282
3283   - Reorganized some of the responsibilities of various methods, which
3284     allows modules to be built and tested programmatically.
3285
3286   - The 'clean' action will now clean up files that were created more
3287     recently than the on-disk cleanup registry was written.
3288
3289   - Undefined values from Config.pm are handled correctly now.
3290
3291   - The dispatch() method will now accept explicit dispatch
3292     parameters, for use in a programmatic setting.
3293
3294   - $ENV{TEST_VERBOSE} will be set in test scripts if the 'verbose=1'
3295     parameter is set.
3296
3297   - Moved the test.pl script to t/basic.t
3298
3299   - Created the t/xs.t script, which tests building a module with a
3300     .xs component.
3301
3302   - Fixed the loading of $^O-specific modules (there were no such
3303     modules before).
3304
3305   - Added a 'darwin' platform module, which removes -flat_namespace
3306     from $Config{ccflags} while building .xs modules (it's a linker
3307     flag, not a compiler flag).
3308
3309   - Now uses $^W instead of the 'warnings' pragma, which apparently
3310     provides compatibility with perl 5.005 (I've only tested it with
3311     5.6.x myself).
3312
3313   - If a file called C<visual.pl> exists in the top-level directory,
3314     this file will be executed as a Perl script during 'Build test' and
3315     its output will be shown to the user.  This is a good place to put
3316     speed tests or other tests that don't use the C<Test::Harness> format
3317     for output.
3318
3319   - The 'Build install' step will now put .xs-related things in the
3320     correct architecture-dependent libraries.
3321
3322   - Added the 'autosplit' option, even though I think autosplitting is
3323     a load of hooie.
3324
3325 0.03  Sun Nov 11 14:58 CDT 2001
3326   - The 'perl Build.PL' step will now detect whether the current
3327     environment is "unixish", "windowsish", etc., and load the correct
3328     module (i.e. Module::Build::Platform::Unix).  More specific
3329     modules may also be written for particular values of $^O.
3330
3331   - Module::Build will now process any .xs files in the lib/
3332     directory.  Please let me know whether this works or not with your
3333     distribution & platform.  I'll be trying out various distributions
3334     on my platform.
3335
3336   - Corrected some embarassing errors in the POD documentation.  Also
3337     added a long documentation section on the various build actions
3338     (test, install, build, etc.) and added some neato ASCII art.
3339
3340   - Added a 'cleanup' mechanism - any method may call the
3341     $self->add_to_cleanup(@files) method to register files which need
3342     to be cleaned up during 'Build clean'.
3343
3344   - Added a 'Build help' action that gives a little syntax help, and
3345     lists all the actions available.
3346
3347   - Fixed a bug in which 'blib/' wasn't properly being added to @INC
3348     when running 'Build test'.
3349
3350   - For the 'Build dist' action, we'll use the 'tar' and 'gzip'
3351     programs (as specified by Config.pm) on Unix platforms, otherwise
3352     we'll use Archive::Tar and Compress::Zlib.
3353
3354 0.02  Wed Sep  5 00:53:04 CDT 2001
3355   - Added POD documentation.
3356
3357   - Added the 'install', 'fakeinstall', and 'dist' actions.
3358
3359   - new() will now determine version string based on 'module_version', or
3360     'module_version_from', or 'module_name', in that order.
3361
3362   - Module::Build::Base handles its file paths in a platform-independent
3363     way, using the File:: modules
3364
3365
3366 0.01  Sun Aug  5 01:23:10 2001
3367   - original version; created by h2xs 1.1.1.4 with options -XA -n Module::Build
3368