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