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