These Module::Build tests depended on STDIN. Unfortunately, cron
[p5sagit/p5-mst-13.2.git] / lib / Module / Build / Changes
CommitLineData
bb4e9162 1Revision history for Perl extension Module::Build.
2
dc8021d3 30.28 Thu Apr 27 22:25:00 CDT 2006
4
5 - When y_n() or prompt() are called without a default value and the
6 build seems to be unattended (e.g. in automatic CPAN testing), we
7 now die() with an error message rather than silently returning
8 undef for prompt(), or looping indefinitely for y_n().
9
10 - When searching for '.modulebuildrc', return the first HOME-like
11 directory that actually contains the file instead of the first
12 existing directory. Document the search locations and the order
13 searched. [Spotted by David Golden]
14
15 - Split the API documentation out of Module::Build::Authoring into
16 its own document: Module::Build::API.
17
18 - We should not emit a warning if a Module::Build subclass is
19 required in a Makefile.PL that is not bundled in the current
20 distribution; it may be installed on the user's system. [Spotted by
21 Tyler MacDonald]
22
23 - copy_if_modified() now preserves the executable bit of the source
24 file. [Spotted by Julian Mehnle]
25
26 - Fixed compatibility of our screen-scraping the Test::Harness output
27 so we can recognize the most recent Test::Harness version. [Steve
28 Hay]
29
30 - Backing out a requirement added in 0.27_06 on the method y_n()
31 to always include a default. This behavior would cause existing
32 build scripts to start failing. We now fail with a missing default
33 only when $ENV{PERL_MM_USE_DEFAULT} is set because there is no
34 reasonable default.
35
36 - Make install_types() method smarter with respect to custom install
37 types.
38
39 - Add documentation for the install_base_relpaths() and
40 prefix_relpaths() methods. Improved their usage for a public API,
41 and added tests.
42
430.27_10 Tue Mar 28 22:50:50 CST 2006
a314697d 44
45 - Added the create_packlist property, default true, which controls
46 whether packlist files will be written during installation. This
47 was already part of Module::Build 0.2609, but for some reason we've
48 forgotten it in the 0.27_xx series. [Spotted by Steve Kirkup]
49
50 - Document the versions of Module::Build where each feature, action,
51 constructor argument, and method was first publicly documented.
52
53 - More fixes for find_perl_interpreter() to work with BSD flavored
54 UNIX: Ensure we always return absolute paths; throw an exception
55 upon failure to find correct interperter; document everything.
56
57 - We now include our own YAML.pm work-alike that we can use when the
58 real YAML isn't installed. We might soon even start using it when
59 YAML is installed, because the YAML API and dependency chain have
60 been changing in unfavorable ways lately. [Stephen Adkins]
61
62 - Fixed some shell-argument-quoting issues on VMS. In the process,
63 we have added some support for avoiding tripping over
64 shell-argument-quoting issues on other platforms too. [Initial
65 patch by Craig A. Berry]
66
47f13fd5 670.27_09 Sat Mar 11 22:48:54 EST 2006
68
69 - Fixed find_perl_interpreter() so we can find the perl executable
70 when running from uninstalled perl even when $^X contains a
71 relative path. [Yitzchak Scott-Thoennes]
72
73 - Fixed warning message where we were printing the wrong field names.
74 [Chris Dolan]
75
76 - Added a 'testpodcoverage' action that runs a POD coverage check for
77 all modules in the distribution. [Yanick Champoux]
78
79 - Added a Cookbook example of subclassing to modify an action. [Dylan
80 Martin and David Golden]
81
82 - When building HTML documentation, we were opening the POD file and
83 not checking whether the open succeeded, which of course caused
84 problems down the line if it failed. Now we do "or die(...)" like
85 everywhere else. [Spotted by Joerg Braun]
86
bb4e9162 870.27_08 Fri Mar 3 21:22:41 CST 2006
88
89 - Due to shell quoting issues and differences in syntax between
90 various flavors of Windows, the code for the 'pl2bat' utility
91 distributed with Perl has been incorporated into M::B::P::Windows.
92 [Thanks to Dr Bean and Ron Savage for help testing and isolating
93 the problem.]
94
95 - Modify add_build_element() so that it only adds elements if they
96 don't already exist. [David Wheeler]
97
98 - Fixed a bug in the 'pass-through' Makefile.PL in which we would die
99 if CPAN::Shell->install returned false, but apparently this return
100 value is unreliable. Now we only die if the module is actually
101 unavailable after installation.
102
103 - Fixed testing problems on VMS related to non-case-preserving
104 filesystems. We now bundle Tie::CPHash in the distribution (just
105 for testing purposes, it doesn't get installed) to help with
106 this. [Craig Berry and Yitzchak Scott-Thoennes]
107
108 - We incorrectly documented the 'dynamic_config' flag in the META.yml
109 file as having a default value of false, but according to the
110 META.yml spec (which, for heaven's sake, we wrote) its default
111 value is true. Fixed. [Spotted by Adam Kennedy]
112
113 - The have_c_compiler() method was dying if the ExtUtils::CBuilder
114 module wasn't around, which is obviously an unhelpful thing to do.
115 Now it just returns false. [Spotted by John Peacock]
116
117 - Fix detection of $VERSION expressions that are not
118 assignments. [Spotted by Chris Dolan]
119
120 - Obfuscate one of our constructs that uses a $VERSION variable,
121 because it was getting picked up by ExtUtils::MakeMaker's
122 version-finder. [Spotted by Randal Schwartz]
123
124 - The config_data script for querying and/or setting a module's
125 config data was forgetting to call write() after setting config
126 values (though setting feature values was working fine).
127 Fixed. [Brian Duggan]
128
129 - On Windows, remove the pl2bat generated 'Build.bat' script without
130 the annoying "The batch file cannot be found." error. [Solution
131 provided by RazTK and foxidrive on newsgroup alt.msdos.batch]
132
133 - Our version comparisons should now work correctly with modules that
134 use version.pm to delcare their versions (e.g. "our $VERSION =
135 version->new('1.0.0')"). [John Peacock and Ron Savage]
136
137 - We now create a Build.bat script on versions of Windows where it
138 makes sense. [Yves]
139
140 - Fixed the verbiage around choosing the correct make-alike on
141 different platforms to suggest using 'perl -V:make'. [Suggested by
142 anonymous user]
143
1440.27_07 Wed Feb 1 20:07:45 CST 2006
145
146 - The notes() method now returns the new value when called with two
147 arguments, just like when it's called with one argument. [Tyler
148 MacDonald]
149
150 - The notes() method now distinguishes among the values undef, 0, and
151 the empty string, where previously it didn't. [Tyler MacDonald]
152
153 - We now unshift(@INC) rather than push(@INC) for the directory where
154 a build subclass lives, so that we're sure to pick up the right
155 version and not some already-installed version. [perlmonkey]
156
157 - The SIGNATURE file for version 0.27_06 (and I'm sure for lots of
158 versions before that too!) was messed up, since we were modifying
159 some files after signing. This has been band-aided for the time
160 being by signing twice. [Reported by Chris Dolan]
161
1620.27_06 Mon Jan 23 21:44:54 CST 2006
163
164 - Fixed an undefined-variable warning when building the META.yml file
165 and the author hasn't used the 'module_name' mechanism. [Chris Dolan]
166
167 - We should now work with recent (> 0.49) versions of YAML.pm when
168 creating the META.yml file. [Yitzchak Scott-Thoennes]
169
170 - The y_n() method now requires the default parameter, and the
171 prompt() and y_n() methods have been improved with respect to
172 how they behave/detect when there is no user to ask. We're now
173 more consistent with MakeMaker, including respecting the
174 PERL_MM_USE_DEFAULT environment variable. [Tyler MacDonald and
175 Yitzchak Scott-Thoennes]
176
177 - When building a README file using Pod::Text, work around a bug in
178 Pod::Text 3.01, which expects Pod::Simple::parse_file to take input
179 and output filehandles when it actually only takes an input
180 filehandle. [Yitzchak Scott-Thoennes]
181
1820.27_05 Thu Jan 12 17:39:21 CST 2006
183
184 - In t/common.pl, we were attempting to let the user's installed
185 Test::More take precedence over ours, but getting thwarted by all
186 the test scripts' loading Test::More beforehand. Fixed. [Spotted
187 by Yitzchak Scott-Thoennes]
188
189 - In various test scripts, we were outputting some strings that
190 weren't strictly conformant with Test::Harness's expected input,
191 though it didn't actually cause problems. Now we're more
192 conformant, though not yet strict. [Spotted by Yitzchak
193 Scott-Thoennes]
194
1950.27_04 Fri Dec 23 10:43:34 CST 2005
196
197 - Removed experimental feature that extended the prerequisite system
198 to apply ('requires', 'recommends', and 'conflicts') prereqs to all
199 actions. Most of the internal extensiblity has been retained so
200 that prereq types can easily be added, more selectively.
201
202 - Added a 'prereq_report' action that shows the user a well-formatted
203 list of all prerequisites, the versions required, and the versions
204 actually installed. [David Wheeler]
205
206 - Clarified the directory name that's created during the 'distdir'
207 action. [Suggested by Tyler MacDonald]
208
209 - Fixed a bug when creating the META.yml file without the help of
210 YAML.pm - some common strings weren't quoted & escaped properly.
211 Now only some uncommon ones are. [Spotted by Joshua ben Jore]
212
213 - Fixed a bug in which an "UNINST=1" argument specified to a
214 passthrough Makefile's "make install" wasn't actually seen by
215 Module::Build.
216
217 - Rather than dying when the Build script is run from the wrong
218 directory, it now simply chdir()s into the right directory and
219 keeps going. [Suggested by Dominique Quatravaux]
220
221 - Added an "Examples on CPAN" section to the cookbook, with an
222 initial entry pointing to John Peacock's SVN-Notify-Mirror
223 distribution.
224
225 - Add an invoked_action() method to return the name of the original
226 action invoked by the user.
227
228 - Add 'meta-spec' field to the generated META.yml file, including the
229 version of the specification followed by the current Module::Build
230 and the url where the specification can be found.
231
232 - Introduced two actions, 'html' & 'manpages', that generate
233 documentation for POD when the respective feature is enabled. The
234 actions will generate the documents even if there is no set place
235 to install to. However, if the actions are invoked as a dependency
236 of another action (e.g. build), the documentation will only be
237 built when there is a default or user-specified place to install to.
238
239 - Added support for environment variable, 'MODULEBUILDRC', which can
240 be used to specify the full path to an option file to use instead
241 of the default location of ~/.modulebuildrc. A special undocumented
242 setting of 'NONE' tells Module::Build not to load any user settings,
243 so tests can be run without tainting from user options.
244
245 - Documented and improved preliminary support for more Getopt::Long
246 style options are supported, including boolean options (--verbose,
247 --no-verbose), and use of hyphens in option names in addition to
248 underscores.
249
250 - The option to disable/enable reading of the ~/.modulebuildrc file
251 is changed from 'skip_rcfile' to 'use_rcfile'
252
253 - Allow the 'distmeta' action to continue when 'MANIFEST' is missing,
254 omitting the generation of the 'provieds' field. [Steven Schubiger]
255
256 - Fixed some failing regex from generated MANIFEST.SKIP file.
257
258 - Fixed an edge case in $VERSION parsing where we thought a package()
259 declaration was happening but it wasn't. [David Golden]
260
261 - Added docs for the install_destination() and install_types() methods.
262
2630.27_03 (Beta for 0.28) Mon Oct 10 11:19:23 EDT 2005
264
265 - We now use ExtUtils::CBuilder to do all compiling of C code (for
266 example, when compiling XS modules). (This change actually
267 occurred in 0.27_01, but it was mistakenly omitted from the Changes
268 file.)
269
270 - Fixed an issue on Win32 (and other case-tolerant
271 non-case-preserving systems, possibly like VMS?) in which the
272 current working directory would sometimes be reported with
273 different case, fooling us into thinking that we were in the wrong
274 directory. [David Golden]
275
276 - The extra_compiler_flags setting was not actually being passed
277 along to ExtUtils::CBuilder so it could pass it along to the
278 compiler. Now it is.
279
280 - The synonyms 'scripts' and 'prereq' for 'script_files' and
281 'requires' were broken in a previous version (0.27_01, probably),
282 but now they're fixed. [David Golden]
283
284 - Previously, we assumed that any custom subclass of Module::Build
285 was located in _build/lib/. This is only true if the author used
286 the subclass() method, though. We now use %INC to find where the
287 custom subclass really is, so that we can "use lib" it. We also
288 issue a warning if it seems to be outside the build directory.
289 [Spotted by Peter Tandler]
290
291 - Added a URL for each license type that we know about, which will
292 appear as resources=>license: in the generated META.yml file.
293
294 - If the user passes a no_index parameter to our constructor, we now
295 pass that through when building the META.yml file. [Richard
296 Soderberg, RT #9603]
297
298 - A few more status messages can now be suppressed by using 'quiet'
299 mode. [Dave Rolsky]
300
301 - Added some more entries to the default MANIFEST.SKIP file. [Chris
302 Dolan]
303
304 - Our POD parser will now accept "AUTHORS" as well as "AUTHOR" when
305 looking for the author list in a module. [David Wheeler]
306
307 - When looking for the POD to auto-generate a README file, or for the
308 AUTHOR or ABSTRACT for the distribution, we now also look for a
309 *.pod with the same name as the *.pm file specified by
310 'version_from'. [David Golden]
311
312 - The recommended dependency on ExtUtils::ParseXS has been moved into
313 the "C_support" auto_feature.
314
315 - When building XS files, we now pass the -DVERSION and -DXS_VERSION
316 flags to the compiler. [Spotted by Jerry Hedden]
317
318 - If a distribution has XS files and Module::Build has not been
319 configured with the "C_support" feature, we now issue a
320 warning. [Suggested by Jerry Hedden]
321
322 - Added a dir_contains() method.
323
324 - Some versions of MakeMaker, CPANPLUS, and/or PAUSE thought that a
325 certain line of our code was declaring a $VERSION when we didn't
326 intend to. The line has been obscurified so they won't think that
327 anymore. [Jos Boumans, RT #14226]
328
329 - Added the Apache, MIT, and Mozilla licenses to the list of licenses
330 that this module knows about. [Bob Ippolito]
331
332 - Fixed a pretty significant typo in the documentation for
333 auto_features. [Spotted by Jonas B. Nielsen]
334
335 - In order to aid people who want to do customization of the META.yml
336 file, we've added a "metafile" property that can then be easily
337 overridden in subclasses, changed do_create_meta_yml() to
338 do_create_metafile(), and split out the code that actually
339 generates the YAML into a new method, write_metafile(). [David
340 Wheeler]
341
342 - Fixed a couple of non-helpful behaviors with extra_compiler_flags
343 and extra_linker_flags. These will automatically be run through
344 split_like_shell() when given to new() as strings.
345
346 - When the user doesn't have ExtUtils::ParseXS installed and we use
347 the old 'xsubpp', the displayed command line for creating the .c
348 file from the .xs file was missing its newline. Now it's got it.
349
3500.27_02 (Beta for 0.28) Fri Jul 15 07:34:58 CDT 2005
351
352 - Provided initial support for the --prefix installation parameter,
353 which acts like MakeMaker's PREFIX. It is still highly recommended
354 NOT to use it when you could reasonably use --install_base or
355 --install_path or --install_dest, but that's just because the way
356 --prefix is designed is weird and unpredictable. Ultimately the
357 choice rests with the installing user. [Patches by Michael Schwern
358 and Rob Kinyon]
359
360 - Fixed a bug in subclass() which prevented people from using it to
361 subclass subclasses of Module::Build. [Chris Dolan]
362
363 - Added a 'pure_install' action, which for the time being is
364 identical to the 'install' action. [Jos Boumans]
365
366 - Fixed a POD error in an L<http://...> tag. [Offer Kaye]
367
368 - Note several options for automatically creating a new module dev
369 tree. [Suggested by Eric Wilhelm]
370
371 - Removed some hard-coded references to File::Spec::Unix in the
372 creation of HTML docs, which should help that code work in more
373 places, and help people not to panic when they look at it. [Spotted
374 by Yves]
375
376 - We now use Pod::Readme by default (instead of Pod::Text) to
377 generate the README file when the 'create_readme' option is used.
378 If Pod::Readme is not installed, we will still fall back to using
379 Pod::Text. [Robert Rothenberg]
380
381 - The values of the "prefix", "install_base", "install_path", and
382 "install_dest" parameters can now begin with "~" or "~user", and
383 we'll de-tilde-ify them by using glob().
384
385 - The (optional) auto-creation of the README and Makefile.PL files
386 have been moved from the 'distdir' action to the 'distmeta'
387 action. [David Golden]
388
389 - When looking for a .modulebuildrc file, we now use a fancier method
390 of trying to find the home directory, because $ENV{HOME} isn't a
391 very cross-platform variable. [Robert Rothenberg]
392
393 - We now memoize the output of the internal _default_INC() method,
394 since it uses backticks and might be kind of slow.
395
396 - When processing XS files, we now look for a typemap in lib/ as well
397 as using the system's default typemap. [John Peacock]
398
399 - The DESTDIR, PREFIX, and INSTALL_BASE arguments to "make install"
400 are now supported for pass-through Makefiles (they've been
401 supported for quite a while as arguments to "perl
402 Makefile.PL"). [Requested by Guillaume Rousse]
403
404 - Test::Harness has changed its output format in recent versions,
405 which threw off one of our tests. We now allow for this different
406 format. [Reported by Scott Godin]
407
408 - Fixed an issue that prevented Module::Build from upgrading itself
409 using its own API (which is how CPANPLUS uses it). There are still
410 some issues with this solution, however. See ticket #13169 in
411 rt.cpan.org. [Reported by Jos Boumans]
412
413 - Fixed a fatal error that occurred when a distribution's author
414 could not be determined from its POD nor from the call to
415 Module::Build->new() in its Build.PL. See ticket #12318 in
416 rt.cpan.org. [Reported by Jos Boumans]
417
418 - Apparently on Windows and cygwin it's not possible to use the "-pi"
419 switch to perl without a backup extension, so now we use ".bak" and
420 remove the backup file when we're done. Thus the "dist" action for
421 Module::Build itself can now be run on those platforms. [Yitzchak
422 Scott-Thoennes]
423
424 - Improved the handling of auto_features in the config_data access
425 script. [Yitzchak Scott-Thoennes]
426
4270.27_01 (Beta for 0.28) Fri Apr 15 21:12:57 CDT 2005
428
429 Backward-incompatible (but better) changes:
430
431 * When using the 'install_base' option to choose a directory for
432 installing everything, perl modules now go into lib/perl5/ instead
433 of just lib/. It seems this is more consistent with people's
434 expectations, and the way I had it before was a bit peculiar to the
435 way I like things in my own home directory. [Michael Schwern]
436
437 * When the user is using the 'install_base' option, scripts will now
438 be installed by default in $install_base/bin/ rather than
439 $install_base/script/ . [Jan Hudec and Michael Schwern]
440
441 Major changes:
442
443 - The auto_features mechanism will now re-evaluate dependencies every
444 time feature() is called for an auto-feature, rather than freezing
445 the success/failure value during 'perl Build.PL' and using that
446 value for all eternity (or module update, whichever comes first).
447 This applies to both $build->feature() and
448 FooModule::ConfigData->feature() calls. [Requested by many]
449
450 - Added the meta_add and meta_merge mechanisms, which let the module
451 author add/merge arbitrary entries into the META.yml file.
452
453 - Now reads per-action default options from '$ENV{HOME}/.modulebuildrc'
454 if it exists. Command line options override anything set in the rc file.
455
456 - We now use ExtUtils::CBuilder to do all compiling of C code (for
457 example, when compiling XS modules).
458
459 - The creation of Unix man pages is no longer a strict necessity - it
460 has now been turned into an 'auto-feature' contingent on the
461 presence of Pod::Man and a location specified for man pages to go.
462
463 - A user-specified 'install_path' setting will now take precedence
464 over an 'install_base' setting. This allows the user to use
465 'install_base' to set the base for all elements in one go, and then
466 use 'install_path' to override specific paths or add paths for
467 additional kinds of targets.
468
469 - Split the main documentation from 'Module/Build.pm' into two
470 sections. The user level documentation and overview remains in
471 'Module/Build.pm', while a new document,
472 'Module/Build/Authoring.pod', has been created for module authors.
473
474 Minor changes:
475
476 - new_from_context() was losing its arguments in some cases (and not
477 because of inadequate training in forensic debate) - we now pass its
478 arguments directly to the Build.PL script rather than merging them
479 in afterwards.
480
481 - Let resume() return an object blessed into the appropriate class
482 if the user has provided a subclass, as specified by the
483 'build_class' property. This allows current() and new_from_context()
484 to behave more like factory methods returning objects of the correct
485 class based on context. [Ray Zimmerman]
486
487 - Refactored methods relating to parsing perl module files for
488 package, version, and pod data into a new class:
489 Module::Build::ModuleInfo. It should not be considered part of
490 Module::Build's API, because we may split it out entirely as a
491 separate CPAN module that we depend on.
492
493 - Added new method Module::Build::prepare_metadata() for authors to
494 override in order to add custom fields to META.yml.
495
496 - We now use Test::More for our regression tests. If the user
497 doesn't have it installed, we include a copy in t/lib/ that we can
498 use during testing.
499
500 - When copying files in the 'distdir' action, set permissions to match
501 the original files. [Julian Mehnle]
502
503 - When adding files like META.yml to the MANIFEST, we now tell the
504 user we're doing so by printing one of the "Added to MANIFEST: ..."
505 lines. [Ron Savage]
506
507 - Added a runtime_params() method, which lets a module author see
508 which parameters were overridden by the user on the command line
509 (or in whatever paradigm the user originally invoked Module::Build
510 from). [David Wheeler]
511
512 - Added the current_action() method, which, surprisingly, returns the
513 name of the currently running action. [David Wheeler]
514
515 - Added docs for run_perl_script().
516
517 - Added some stuff to the docs about why PREFIX is unsupported, and
518 what to use instead. [Steve Purkis]
519
520 - The simple get/set accessor methods for all the 'parameters' like
521 verbose(), license(), etc. now have auto-generated documentation in
522 Module/Build.pm.
523
524 - Created a Cookbook entry for 'Adding new elements to the install
525 process'
526
527 - We now add META.yml to the MANIFEST when META.yml is created, not
528 when MANIFEST is created. [Spotted by Ron Savage]
529
530 - Added some additional patterns to the suggested MANIFEST.SKIP
531 contents, and changed the docs so that we encourage the user to use
532 the MANIFEST.SKIP. [Ron Savage]
533
534 - Eliminated a redundant recipe from the Cookbook, now that there are
535 some more extensive recipes on how to add stuff to the
536 build/install sequences.
537
538 - Eliminated an undefined-variable warning when testing under perl 5.005
539
540 - When building HTML documentation, 'html_backlink' and 'html_css'
541 properties are now first-class properties, so they can be set from
542 the command line. [Suggested by Sagar R. Shah]
543
544 - Have script_files default to everything in bin. I believe this is
545 the least surprising behavior. [Suggested by Michael Schwern]
546
547 - If script_files is given a directory, consider each file in that
548 directory tree as a script to be installed. This avoids having to
549 remember to add to the script_files list every time you add a
550 program. [Suggested by Michael Schwern]
551
552 - We now only load Pod::Man when we actually need to build man pages.
553
554 - We now make Test::Harness use our carefully-selected path to a perl
555 executable regardless of Test::Harness's version. Previously we
556 let it figure stuff out for itself if it was a reasonably modern
557 version, but it's safer to make sure we're using the same perl
558 everywhere.
559
5600.2610 Fri Apr 15 08:25:01 CDT 2005
561
562 - new_from_context() was losing its arguments in some cases (and not
563 because of inadequate training in debate) - we now pass its
564 arguments directly to the Build.PL script rather than merging them
565 in afterwards. [Ray Zimmerman]
566
567 - Fixed a bug in which config_data and feature data were being
568 forgotten and no ConfigData.pm module would get written. [Ray
569 Zimmerman]
570
571 - Added a recipe to the cookbook showing how to run a single test
572 file from the command line. [William McKee]
573
574 - For command-line arguments, we now accept the syntax "--foo=bar" in
575 addition to "--foo bar" and "foo=bar". This seems to fit well with
576 what GNU getopt and Getopt::Long do, and with people's
577 expectations. [Adam Spiers]
578
5790.2609 Wed Mar 16 22:18:35 CST 2005
580
581 - The html docs that were created during the first invokation of
582 './Build' were being found and treated as pod that needed to be
583 converted to html during subsequent invokations. We now are more
584 specific about the directories we scan for pod that needs to be
585 converted, effectively avoiding blib/html. [Ray Zimmerman]
586
587 - If Pod::Man is not available, we now skip building man pages
588 (rather than dying) and tell the user why.
589
590 - We now write a .packlist file upon installation, in the same place
591 that ExtUtils::MakeMaker does. [Johnny Lam]
592
593 - On some Unix platforms (BSD derivatives, mostly) perl's $^X
594 variable isn't set to the full path of the perl executable, just
595 'perl', when the 'Build' script is run as './Build' and not 'perl
596 ./Build'. This can lead to some other modules (maybe
597 Test::Harness, maybe IO::File, I dunno...) getting very confused
598 about where they are, and they try to load stuff from the wrong
599 perl lib, and big trouble ensues. To fix this, we now set $^X to
600 the value of Module::Build->find_perl_interpreter().
601
602 - The 'distcheck' action will now die() if it finds an error in the
603 MANIFEST, rather than just printing on STDOUT. [David Golden]
604
605 - When the README and/or Makefile.PL are autogenerated using
606 create_readme or create_makefile_pl, we now automatically make sure
607 they're also listed in the MANIFEST file. [Suggested by Michael
608 Schwern]
609
610 - Got rid of the t/MANIFEST file - it's superfluous, and it had
611 zero-length, which some versions of Tar don't like. [William
612 Underwood]
613
614 - Added a mention in the documentation that each property that new()
615 accepts also has a corresponding get/set accessor. (In the version
616 0.27_0x series each accessor method is mentioned explicitly in the
617 docs.) [Omission spotted by Ian Langworth]
618
6190.2608 Wed Jan 26 19:46:09 CST 2005
620
621 - Add workaround for test files because Devel::Cover causes
622 require to fail when the argument to require is an expression
623 involving File::Spec. We now assign the result of the File::Spec
624 call to a variable and then call require with that variable.
625
626 - Tilde-expansion is now performed on arguments passed to a
627 compatibility-Makefile.PL [Spotted by Sam Vilain]
628
629 - We now run the 'gzip' and 'tar' values through split_like_shell()
630 when running the 'dist' action, so that e.g. the 'gzip' value can
631 be set to something like "gzip -f --best" and it'll work
632 correctly. [Spotted by Chris Dolan]
633
634 - Work around some bad mojo between Fedora Core [with its very long
635 @INC] and old versions of Test::Harness [with its propensity to
636 compound the number of @INC entries] that produced an "argument
637 list too long" error during testing. [assisted by Ville Skytta,
638 David Golden, & Randy Sims]
639
640 - Killed an infinite loop that would happen in y_n() in interactive
641 mode if the author provided no default value. [Max Maischein]
642
6430.2607 (Bug fix release in 0.26 series) Sat Dec 18 14:14:09 CST 2004
644
645 - Instead of freezing @INC in the 'Build' script to the value it had
646 when Build.PL was run, we now just add those additional values that
647 aren't part of the default compiled-in @INC. [Michael Schwern]
648
649 - The run_perl_script() method will now propagate any extra entries
650 in @INC (such as those added by "use lib" or the -I command-line
651 switch) to the subprocess. This helps situations in which you want
652 to tell the subprocess where to find a certain module, for
653 instance. [Michael Schwern]
654
6550.2606 (Bug fix release in 0.26 series) Tue Dec 7 22:33:11 CST 2004
656
657 - Fixed a linking bug on Win32, in which compiled C code object files
658 never got linked in with the modules being built. [Dominic
659 Mitchell]
660
661 - Fixed a bug in the new_from_context() method in which any arguments
662 passed made us die. [Spotted by Jos Boumans]
663
6640.2605 (Bug fix release in 0.26 series) Tue Nov 30 07:16:13 CST 2004
665
666 - Fixed a bug in which zero-length arguments for hash-valued
667 parameters (e.g. " --config foo= ") weren't being allowed.
668
669 - The tests now play better with environments in which version.pm is
670 pre-loaded, like in bleadperl. [John Peacock & Michael Schwern]
671
672 - Fixed a syntax error in one of the tests under perl 5.005.
673
6740.2604 (Bug fix release in 0.26 series) Wed Nov 17 14:32:42 CST 2004
675
676 - Fixed a split_like_shell() bug introduced in 0.2603 for Windows, in
677 which an array reference passed as an argument was returned as an
678 array reference, rather than as a list. [Spotted by Steve Hay]
679
680 - module_name() will now return '' instead of undef when module_name
681 is not set. This eliminates a couple uninitialized-value
682 warnings. [Suggested by Michael Schwern]
683
684 - The expand_test_dir() method will now skip dotfiles (like ._foo.t,
685 which sometimes gets automatically created on Mac systems) when
686 'recursive_test_files' is in effect. [Tom Insam]
687
6880.2603 (Bug fix release in 0.26 series) Mon Nov 15 10:28:00 CST 2004
689
690 - Added documentation for the new_from_context() method.
691
692 - Completely rewrote the split_like_shell() method for the Windows
693 platform so it works like the command.com shell. [Randy Sims]
694
6950.2602 (Bug fix release in 0.26 series) Thu Nov 4 11:19:29 CST 2004
696
697 - The two bug fixes in 0.2601 gnashed against each other incorrectly,
698 resulting in a Win32 bug in split_like_shell(). Fixed. [Spotted
699 by Steve Hay & Randy Sims]
700
701 - Removed a couple of 'use warnings' statements from the code - they
702 were causing compile failures on 5.005_04, where warnings.pm isn't
703 available. [Blair Zajac]
704
7050.2601 (Bug fix release in 0.26 series) Wed Nov 3 20:09:27 CST 2004
706
707 - Fixed some backslash problems with split_like_shell() on
708 Win32. [Steve Hay]
709
710 - Fixed a bug in split_like_shell() in which leading whitespace was
711 creating an empty word, manifesting as something like "gcc - no
712 such file or directory" during tests. [Spotted by Warren L. Dodge]
713
7140.26 Sat Oct 9 17:51:01 CDT 2004
715
716 - Removed some language from the Module::Build::Compat documentation
717 that encouraged people to include a Build.PL without a Makefile.PL.
718 Also changed "a replacement for MakeMaker" to "an alternative to
719 MakeMaker" in the main documentation, which is basically what I
720 meant all along (i.e. a replacement for MakeMaker in your
721 particular build process - MakeMaker is never going to be fully
722 replaced in the perl world at large, of course), but some people
723 got the impression I was a little more truculent toward MakeMaker
724 than I really am.
725
726 - Added the formal concepts of "features" and "config data" for
727 distributions. This allows the module author to define a certain
728 set of features that the user can switch on and off (usually
729 according to whether they have the proper prerequisites for them),
730 and to save build-time configuration information in a standardized
731 format. See the main documentation of Module::Build for more
732 details. (Note that the name of this system was called
733 "BuildConfig" for a while in beta, but now it's called
734 "ConfigData".)
735
736 - Added an 'auto_features' capability, which simplifies the process
737 of defining features that depend on a set of prerequisites.
738
739 - Added the 'get_options' parameter, which lets module authors
740 declare certain command-line arguments their Build.PL can accept
741 [David Wheeler]
742
743 - Changed the split_like_shell() method to use the shellwords()
744 function from Text::ParseWords (a core module since 5.0), which
745 does a much better job than the split() we were using.
746
747 - Added a 'testpod' action, which checks the syntactic validity of
748 all POD files in the distribution using Test::Pod. This eliminates
749 the need for doing so in a regression test. [Initial patch by Mark
750 Stosberg]
751
752 - Added a process_files_by_extension() method, which generalizes the
753 kind of processing (essentially just copying) that happens for .pm
754 and .pod files, and makes it available to other user-defined types
755 of files. See the new cookbook entry.
756
757 - Improved compatibility with version.pm when authors are using
758 version objects as their $VERSION variables. Now
759 version_from_file() can deal with these objects. Currently we
760 stringify them right away, but perhaps in the future we will
761 preserve them as objects for a while.
762
763 - During 'distdir' and 'distmeta' actions, die a bit more gracefully
764 if there's no MANIFEST (i.e. explicitly say that a MANIFEST is
765 required). [Spotted by Adrian Howard]
766
767 - Eliminated a recursive dependency between creating the MANIFEST
768 file and creating the META.yml file. [Spotted by Dave Rolsky]
769
770 - On Win32, where a single directory might be known variously as
771 "Module-Build-0.25_03" or "MODULE~1.25_", we now use
772 Win32::GetShortPathName($cwd) to verify that the 'Build' script is
773 being run from the correct directory, rather than just a string
774 comparison.
775
776 - The add_to_cleanup() method will now accept glob()-style patterns
777 in addition to explicit filenames. Also documented the fact that
778 they can be specified in either Unix-style or native-style
779 notation.
780
781 - Passing a PREFIX value to a pass-through Makefile 'make install'
782 now has the same effect as passing it to 'perl Makefile.PL' (it
783 dies with a helpful message).
784
785 - Added the 'testcover' action, which runs a test suite using
786 Devel::Cover. [Dave Rolsky]
787
788 - Added the 'lib' and 'arch' installation directories to the search
789 path for the 'diff' action, since they won't necessarily (though
790 they usually will) be in @INC at installation time. [Suggested by
791 Kevin Baker]
792
793 - The "=head3" POD directive isn't supported in older podlators
794 (particularly Pod::Man), so we don't use it anymore.
795
796 - Fixed a typo & improved the docs in the SUBCLASSING section. [Ron
797 Savage]
798
799 - Added the '.tmp' suffix to the default MANIFEST.SKIP file, which
800 should avoid adding things like pod2htmi.tmp to the MANIFEST [Ron
801 Savage]
802
803 - Backup files from Emacs, containing the string '.#' in their names,
804 should no longer find their way into the blib/ directory (and from
805 there into installation directories).
806
807 - Worked around an unpleasant interaction between version.pm and the
808 version-checking code that makes sure Module::Build's version
809 hasn't changed during the lifetime of the 'Build' script. [Reported
810 by Trevor Schellhorn]
811
812 - Fixed a problem in htmlify_pods() that would produce test failures
813 on Cygwin (and probably elsewhere). [Yitzchak Scott-Thoennes]
814
815 - Fixed a test failure on Cygwin (and probably elsewhere) in
816 t/compat.t, resulting from empty environment variables being set to
817 the empty string (as opposed to simply being unset) by their mere
818 presence in the "EXPORT:" list.
819
820 - Fixed a fatal error that occurred when the author specified
821 'dist_author' manually in their Build.PL script. [Spotted by Ron
822 Savage]
823
824 - The 'provides' section of the META.yml file wasn't being built
825 properly on Win32, because of a mismatch between URL-format and
826 native-format pathnames. Fixed. [Reported by Robert Rothenberg]
827
828 - The progress message "lib/Foo.xs -> lib/Foo.c" was previously being
829 output even when the Foo.c file wasn't being rebuilt. It's now
830 fixed.
831
832 - Fixed a couple of places in Compat.pm where it could have forgotten
833 which perl interpreter it had been run with ($^X isn't very
834 trustworthy).
835
836 - On some systems, the way we updated the timestamp on the
837 "lib/Foo.bs" file (one of the output files for XS-based modules)
838 was failing. It's been replaced by a simple call to utime().
839
840 - Fixed a problem in t/compat.t that prevented it from being run
841 individually using 'make test TEST_FILES=t/compat.t'. The problem
842 was that a couple environment variables (TEST_FILES, MAKEFLAGS)
843 were being passed through to subprocesses, and confused them.
844
845 - Fixed an important typo in the documentation for the 'install_base'
846 parameter ('libdoc' and 'bindoc' were switched). [Ray Zimmerman]
847
848 - The pass-through Makefiles (type 'small' or 'passthrough') now
849 support the TEST_FILES parameter to 'make test'.
850
851 - Fixed a fatal error that would occur on perl 5.005 when building
852 HTML documentation, because its version of Pod::Html was old and
853 didn't like some of the parameters we fed it. [Spotted by Blair
854 Zajac]
855
856 - The final line of the generated pass-through Makefile was missing
857 its trailing newline, which is now fixed. [Chip Salzenberg]
858
859 - We now depend on YAML version at least 0.35 and at most version
860 0.49, so that we don't pick up a new (and backward-incompatible) beta
861 version from CPAN.
862
863 - Squashed a warning in t/basic.t about '"Foo::Module::VERSION" used
864 only once', and one in PPMMaker about $^V being undefined. [Blair
865 Zajac]
866
867 - Added a couple temporary output files from HTML documentation
868 generation to the cleanup list. [Toby Ovod-Everett]
869
870 - The PodParser module will now only extract paragraphs in the
871 'AUTHOR' section of the pod if they contain an '@' character. This
872 tends to do a better job, heuristically speaking, of returning
873 relevant stuff.
874
875 - Added regression tests and a helper method ( add_build_elements() )
876 for adding new elements to the build process. Also some
877 documentation.
878
879 - Wrote a recipe in the Cookbook for adding new elements to the build
880 process, and a recipe for changing the order in which the steps in
881 the build process will occur.
882
8830.25 Sun Apr 25 11:12:36 CDT 2004
884
885 - During the 'distdir' action, if no MANIFEST.SKIP file exists, we
886 will now create a reasonable default one. [Randy Sims]
887
888 - In Makefile compatibility mode, some arguments (like UNINST,
889 TEST_VERBOSE, etc.) given to 'make' are now recognized and passed
890 through to Module::Build. [Randy Sims]
891
892 - The regression tests now make sure that several pass-through
893 Makefile.PL parameters are dealt with correctly.
894
895 - Added support for the 'LIB' parameter to passthrough
896 Makefile.PLs. [Spotted by Jesse Erlbaum]
897
898 - Passing a 'PREFIX' parameter to a passthrough Makefile.PL was
899 supposed to make it die with a helpful error message, but instead
900 it just ignored it and blindly tried to install to the wrong place.
901 This is now fixed. [Spotted by Jesse Erlbaum]
902
903 - Added an extra_compiler_flags() accessor method.
904
905 - If the 'recursive_test_files' option was turned on, the test files
906 weren't sorted, but returned in an apparently random order. Now
907 they're sorted. [Martyn Peck]
908
909 - Documented the 'tar' and 'gzip' parameters to the 'dist' and
910 'ppmdist' actions.
911
912 - The generation of HTML documentation now works (it was accidentally
913 partially implemented with an itchy patch-application finger in
914 0.24). [Randy Kobes]
915
916 - Fixed a fatal bug when building META.yml with YAML.pm and
917 'dynamic_config' is set. [Reported by Jaap Karssenberg]
918
919 - Fixed some incorrect error messages that occurred when
920 compiling/linking C sources went awry.
921
922 - If the author uses a custom builder subclass, that subclass will
923 now be loaded correctly in the passthrough Makefile.PL if the
924 author uses the 'small' or 'passthrough' Makefile.PL options in
925 Module::Build::Compat. [Martyn Peck and Jaap Karssenberg]
926
927 - If the author uses a custom builder subclass created dynamically
928 through the subclass() method, passthrough Makefile.PLs (of type
929 'passthrough' or 'small') didn't work properly, because the custom
930 builder module wouldn't be loaded at the right time. This has been
931 fixed. [Reported by Toby Ovod-Everett]
932
933 - In M::B-generated 'traditional' Makefile.PLs, the entries in
934 'PREREQ_PM' are now sorted ASCIIbetically rather than randomly.
935
936 - The install_types() method will now return any additional types
937 given as 'install_path' arguments, as well as all elements of the
938 current 'install_sets' entry. This makes it easier to add new
939 types of installable objects to the mix.
940
941 - As a consequence of the previous change, there is no longer any
942 need to have an explicit 'install_types' data member, so it has
943 been removed.
944
945 - In the second example code for the Module::Build->subclass()
946 method, the Module::Build module needed to be loaded before calling
947 its methods. [John Peacock]
948
949 - Fixed minor error in the POD structure of Module::Build and
950 Module::Build::Platform::VMS docs.
951
952
9530.24 Wed Feb 25 15:57:00 CST 2004
954
955 - Fixed a problem with incude_dirs not being propagated to the 'ccs'
956 file when compiling XS files on Win32. [Randy Sims and Steve Hay]
957
958 - In 0.23, Module::Build::Compat->fake_makefile() started choking
959 when no 'build_class' parameter was supplied in the Makefile.PL.
960 Since these Makefile.PLs still exist on CPAN, we now default
961 'build_class' to 'Module::Build', which was the old 0.22 behavior
962 anyway. [Reported by Martin Titz and Jeremy Seitz]
963
964 - Added documentation for the 'include_dirs' parameter to
965 new(). [Steve Hay]
966
967 - Changed the no-op command on Win32 from 'rem' to 'rem>nul' inside
968 pass-through Makefiles. [Randy Sims]
969
970 - The 'autosplit' parameter now accepts an array reference if
971 multiple files should be split. [Jaap Karssenberg]
972
973 - find_perl_interpreter() will now use $^X (if absolute), $ENV{PATH}
974 (if $^X isn't absolute), and $Config{perlpath}, in that order.
975 Also, we now make darn sure the result is the same version of perl,
976 by checking Config::myconfig() for a match against the current
977 perl. [Reported by Edward Sabol]
978
979 - Fixed a fatal error on Win32 (and any other platform that doesn't
980 define an installation location for Unix-style man pages) during
981 installation.
982
9830.23 Sun Feb 8 22:01:18 CST 2004
984
985 - Fixed a compatibility problem in pass-through Makefiles (created by
986 Module::Build::Compat). Some 'make' utilities (for example, BSD
987 make) didn't like a '@' by itself on a line, so we stole some
988 'NOOP' code from MakeMaker to fix it. [Reported by Mathieu Arnold]
989
990 - Added a 'ppm_dist' action, which just makes the PPD file and then
991 makes a tarball out of the blib/ directory. [Randy Sims]
992
993 - The @INC of the parent process is now propagated to child processes
994 when processing *.PL files. [Reported by Jaap Karssenberg]
995
996 - We now only attempt to fix the shebang line on a script if the
997 shebang line matches the regex /perl/i . This fixes some instances
998 where people put shell scripts in their distributions. [Jaap
999 Karssenberg]
1000
1001 - We no longer generate a 'requires', 'recommends', 'conflicts',
1002 etc. entry in the META.yml file if there's no data to go in it.
1003
1004 - Added a documentation reference to Michael Schwern's wiki for tips
1005 on conversion from MakeMaker to M::B. [Randy Sims]
1006
1007 - If there are script_files, we now add EXE_FILES to the
1008 'traditional' Makefile.PL generated by M::B::Compat. [Suggested by
1009 Yuval Kogman]
1010
1011 - Documented the 'test_files' parameter to new(). [Reported by Tony
1012 Bowden]
1013
1014 - Fixed a problem in "Build help <action>", which didn't find the
1015 correct help chunk if <action> was the final element in a POD
1016 list. [Jaap Karssenberg]
1017
1018 - Fixed a problem in the get_action_docs() method which gave
1019 incorrect results if the method was called more than once in the
1020 same program.
1021
1022 - Fixed a problem in which actions defined by user subclasses
1023 wouldn't be available via the pass-through Makefiles created by
1024 Module::Build::Compat. [Reported by Jaap Karssenberg]
1025
1026 - We now use Data::Dumper instead of our own ad-hoc serialization
1027 routines to create the 'traditional' Makefile.PL
1028 arguments. [Suggested by Yuval Kojman]
1029
10300.22 Sat Jan 10 22:05:39 CST 2004
1031
1032 - On Unixish platforms, the syntax "FOO=BAR /bin/baz arg arg" now
1033 works when present in $Config{ld}. This solves a problem on Mac OS
1034 X 10.3. [Reported by Adam Foxson]
1035
1036 - The have_c_compiler() now also tests whether the linker seems to
1037 work too.
1038
1039 - Fixed a problem with creating the distribution tarball in which
1040 permissions would usually be all read-only. We now use our own
1041 file-copying routines rather than those in ExtUtils::Manifest,
1042 because those do some annoying extra permissions-setting stuff for
1043 no apparent reason. It makes me happy that this was a very very
1044 easy patch to make. [Reported by Thomas Klausner]
1045
1046 - The compile_c() method now includes $Config{cccdlflags} in its
1047 command invocation. It's usually empty, but not always, so we
1048 didn't notice for a while. [Richard Clamp]
1049
1050 - On some platforms it's common to have a $Config{make} defined, but
1051 no 'make' utility actually available. We now detect this and skip
1052 some 'make' compatibility tests. [Randy Sims]
1053
1054 - Fixed a spurious testing failure on non-Unix platforms that
1055 happened because we accidentally call localize_file_path() on empty
1056 strings in the test suite. [Spotted by Randy Sims on Windows]
1057
1058 - Made the 'name', 'abstract', 'author', and 'version' properties
1059 required when building a PPD file. [Spotted by Randy Sims, Dave
1060 Rolsky, & Glenn Linderman]
1061
1062 - When building a 'traditional' Makefile.PL with
1063 Module::Build::Compat, we now use 'VERSION_FROM' when possible,
1064 rather than always using 'VERSION'. This way the Makefile.PL
1065 doesn't have to get modified every release.
1066
1067 - Made some fixups to the 'PPM' info-file, improving compatibility
1068 with ActiveState's PPM tools. [Randy Sims, Glenn Linderman]
1069
1070 - The 'dist_author' property can now accept multiple authors, see the
1071 docs for more info. [Randy Sims]
1072
1073 - If the user doesn't have YAML.pm installed during ACTION_dist, we
1074 now create a minimal YAML.pm anyway, without any dependency
1075 information.
1076
1077 - The 'distribution_type' field is no longer created in META.yml
1078 files, in accordance with the finding made at the London CLPAN
1079 meeting that it's essentially meaningless and ill-defined.
1080
1081 - The 'dist' action now accepts an optional 'tar' parameter to use a
1082 system utility for building the tarball, and a 'gzip' parameter for
1083 compressing it. If these are used, Archive::Tar won't be invoked.
1084 This was added because Archive::Tar is producing some very
1085 non-cross-platform tarballs that many tar utilities can't handle.
1086
1087 - During testing, if YAML.pm isn't installed, then we won't try
1088 making a tarball either, since this would invoke YAML to create the
1089 META.yml file.
1090
1091 - Fixed a problem with chmod() being called incorrectly on MacOS
1092 (i.e. MacPerl, not Mac OS X). [Spotted by Paul Sanford Toney]
1093
1094 - Fixed a problem with the --config flag not being treated properly
1095 (essentially ignored) on the command line for 'perl Build.PL' or
1096 'Build <action>'. [Spotted by Jakub Bogusz]
1097
1098 - Added a new config() method to get at the Build object's notion of
1099 the %Config hash.
1100
1101 - Test::Harness is starting to contend for the Most Crotchety Module
1102 Award. Work around a few of its nits when setting harness
1103 switches. [Spotted by Diab Jerius]
1104
1105 - Now the Build script will die() if we're run from the wrong
1106 directory, rather than trying to chdir() to what it thinks is the
1107 right directory and do its work there. See
1108 https://rt.cpan.org/Ticket/Display.html?id=4039 . [Chris Dolan]
1109
1110 - Changed the manpage separator on OS/2 to '.'. [Ilya Zakharevich]
1111
1112 - On OS/2, disable C compilation, since apparently it isn't working
1113 there. [Reported by Ilya Zakharevich]
1114
1115 - Inserted a comment into auto-generated Makefile.PLs saying it was
1116 auto-generated. [Randy Sims]
1117
1118 - Fixed some annoying behavior in generated passthrough Makefile.PLs
1119 when the user chose not to install Module::Build, or if
1120 installation failed. [Reported by Ilya Zakharevich and Richard
1121 Clamp]
1122
1123 - Moved the documentation for 'codebase' to the section where it's
1124 relevant. [Randy Sims, Glenn Linderman]
1125
1126 - Fixed a have_c_compiler() failure on some platforms, we now define
1127 a boot_compilet() function (since we're compiling a library, not an
1128 executable). [Randy Sims]
1129
1130 - Added a recipe to the Module::Build::Cookbook describing how to
1131 maintain compatibility with older versions of CPAN.pm [Jim Cromie]
1132
1133 - Removed caveat about "looking for alternatives" in how hashes are
1134 specified on the command line, since an alternative has been found.
1135
1136 - Previously most warnings about optional prerequisites looked like
1137 they were actually error messages about required prerequisites.
1138 This has been corrected. [Reported again by Sagar Shah]
1139
1140 - Added support for building XS (and C in general) stuff on AIX.
1141 This was done by a small reorganization of prelink_c() method from
1142 Windows.pm to Build.pm, and it is only invoked for the platforms
1143 that need it invoked. AIX also massages some very naughty bits
1144 (MakeMaker macro variables) in $Config{lddlflags} that should never
1145 have been put there, but alas, they're there, so we find & resolve
1146 them.
1147
1148 - Added OS/2 ($^O = 'os2') to the list of Unix-like platforms. This
1149 basically means that most platform-specific operations will be done
1150 in a Unix-like manner.
1151
1152 - Pass-through Makefiles will now die() when they're given a PREFIX
1153 parameter, and suggest using 'destdir' or 'install_base' instead.
1154 Previously they just ignored the parameter and tried to install to
1155 the default location, which is clearly not what the user wanted.
1156
1157 - Updated my email address in the documentation to a more recent
1158 variant.
1159
1160 - Add NetBSD to the list of Unix-like systems. [Adrian Bunk]
1161
1162 - Add SVR5 to the list of Unix-like systems. [Rafael Garcia-Suarez]
1163
1164 - We now use Pod::Parser to find the ABSTRACT and AUTHOR when it's
1165 available on the system. [initial patch by Randy Sims]
1166
1167 - Fixed a little scalar/list buglet in a documentation example.
1168
11690.21 Wed Oct 15 20:47:05 CDT 2003
1170
1171 - Added a have_c_compiler() method.
1172
1173 - Added documentation for the requires(), recommends(),
1174 build_requires(), and conflicts() methods.
1175
1176 - On Unix platforms, we now create the "Build" script with a #! line
1177 matching the perl interpreter that was used to invoke the Build.PL
1178 script, rather than whatever is in $Config{startperl}. This avoids
1179 a potential warning about the interpreters not matching. [Spotted
1180 by Ken Y. Clark]
1181
1182 - The Unix version now uses the safer multi-argument form of system()
1183 when building distribution tarballs.
1184
1185 - Added a regression test for the 'dist' action to the t/runthrough.t
1186 test.
1187
1188 - Fixed a problem with File::Spec usage when creating the names of
1189 'libdoc' manual pages - the code wasn't dealing with the volume or
1190 file portions correctly on certain platforms.
1191
1192 - When creating the names of the 'libdoc' manual pages, we no longer
1193 assume that pods are under the hard-coded paths 'blib/lib' or
1194 'blib/arch'.
1195
1196 - Fixed a crashing bug that could sometimes occur when the
1197 distribution contained no 'lib' directory. [Chris Dolan]
1198
1199 - Fixed a crashing bug that happened when the user had .PL files in
1200 the lib/ directory and didn't explicitly name them in a hash
1201 reference to the new() constructor. [Chris Reinhardt, bug #4036]
1202
1203 - .PL files are now passed the names of their target file(s) on the
1204 command line when they run.
1205
1206 - When YAML.pm wasn't installed, t/runthrough.t wasn't properly
1207 skipping some tests that required YAML. This is now fixed.
1208 [Stephen J. Smith]
1209
1210 - Added documentation for the dist_version() and dist_name()
1211 methods. [Spotted by Johan Vromans]
1212
1213 - Existing values in $ENV{HARNESS_PERL_SWITCHES} are now respected
1214 and not squashed when we run the 'test' action. [Paul Johnson]
1215
1216 - On cygwin, the separator string for manual page names has been set
1217 to '.'. Previously it was '::', inherited from Unix. [Yitzchak
1218 Scott-Thoennes]
1219
1220 - Avoid a warning when Build.PL is run (i.e. when the new() method is
1221 called) and no MANIFEST file exists. [Michael Schwern and Kevin
1222 Ruscoe]
1223
1224 - Added documentation for the 'code' and 'docs' actions. [Steve
1225 Purkis and Mark Stosberg]
1226
1227 - The internal method compile_support_files() has been renamed to
1228 process_support_files() in order to make it consistent with other
1229 processing methods. Note that it was never documented using the
1230 old name. It's still not documented, actually. Maybe later.
1231
1232 - Skip the 'write' pseudo-entry in the 'diff' action's installation
1233 map. [Chris Dolan]
1234
1235 - Fixed a bug in which notes() set in the Build.PL before
1236 create_build_script() was called would get lost unless more notes()
1237 were also set afterwards. [Spotted by Dave Rolsky]
1238
1239 - The process of building elements of the distribution is now driven
1240 by a list of build elements, paving the way for letting people add
1241 their own types of build elements in future versions of
1242 Module::Build (or in the current version with some difficulty).
1243
1244 - Fixed some linking errors on Cygwin. [Randy Sims, Terrence Brannon]
1245
1246 - Fixed a line-ending problem with detecting the dist_abstract
1247 properly on Cygwin. [Randy Sims]
1248
1249 - Fixed a problem with signatures that occurred if 'distsign' was
1250 called before 'distdir' - the signature would be generated twice.
1251
1252 - Added a 'create_readme' parameter to new(), which will use
1253 Pod::Text to generate a README from the main (dist_version_from)
1254 module file during the 'distdir' action.
1255
1256 - We now refuse to run the 'Build' script if it was created using a
1257 different version of Module::Build. This has caused a couple of
1258 nasty bugs in the past, I don't want to know what it would cause in
1259 the future.
1260
1261 - Documentation for do_system() has been added. [Dave Rolsky]
1262
1263 - run_perl_script() is now available as a class method, though it
1264 will need to (re-)find the perl interpreter in this case.
1265
1266 - Added a new_from_context() method that authors of automated tools
1267 like CPANPLUS and CPAN can use instead of running all tasks as
1268 sub-processes. We also use it in the regression tests for
1269 Module::Build itself. ** Note that this method is currently
1270 undocumented because its name may change in the future. **
1271
1272 - When signing distributions with Module::Signature, we now
1273 automatically add the SIGNATURE file to the MANIFEST, avoiding an
1274 unpleasant chicken/egg problem for the module author.
1275 [unpleasantness spotted by sungo]
1276
1277 - In Module::Build::Compat, added support for the 'verbose' parameter
1278 to Makefile.PL [spotted by Soren Andersen, fixed by Michael
1279 Schwern]
1280
1281 - The Module::Build distribution now has a cryptographic 'SIGNATURE'
1282 file created by Module::Signature.
1283
1284 - Added proper documentation for the subclass() method. [spotted by
1285 Jonathan Steinert]
1286
1287 - Worked around a Config.pm bug in Red Hat 9 which prevented man
1288 pages from being installed in the correct places. [spotted by Ville
1289 Skytta]
1290
1291 - Fixed a Module::Build::Compat bug in which setting INSTALLDIRS
1292 caused a crash. [spotted by Ilya Martynov]
1293
12940.20 Tue Aug 26 14:34:07 CDT 2003
1295
1296 - Separated the 'build' action into two separate actions, 'code' and
1297 'docs'. This is similar to MakeMaker's separation of the 'all'
1298 target into 'pure_all' and 'manifypods'. This fixes a permissions
1299 hassle in which doing 'sudo Build install' would often create local
1300 doc files that needed superuser permissions to delete.
1301
1302 - Enhanced the 'help' action - 'Build help foo' will now show the POD
1303 documentation for the 'foo' action.
1304
1305 - Added a notes() feature, which helps share data transparently
1306 between the Build.PL and t/*.t scripts.
1307
1308 - The installation process will now create man(1) and man(3) pages
1309 from POD in modules & scripts, and install them. We don't build
1310 man pages when there's nowhere to install them, such as on some
1311 Win32 or most Mac systems. [large patch by Steve Purkis, 5.005 fix
1312 by Mathieu Arnold]
1313
1314 - The 'distdir' action now copies files to the distribution
1315 directory, rather than making them hard links to the original
1316 files. This allows authors to do last-minute alterations of the
1317 files without affecting the originals. [Dave Rolsky]
1318
1319 - If the author uses XS files in nonstandard locations, the copied
1320 versions of those files will now be cleaned up properly.
1321
1322 - In invoking the 'test' action or invoking 'xsubpp', we now use the
1323 same perl executable as we use everywhere else, rather than blindly
1324 using $^X or $Config{perlpath} (neither of which are very
1325 reliable).
1326
1327 - Fixed a problem with the 'install_path' parameter given to
1328 'Build.PL' being lost in subsequent actions. [Reported by Mathieu
1329 Arnold]
1330
1331 - Fixed yet another bug with installation directories, in which the
1332 'install_base' parameter wasn't being respected on the command
1333 line. [Spotted by Jonathan Swartz]
1334
1335 - Changed the way the depends_on() method works inside action
1336 subroutines - now each action will only run once per dispatch()
1337 invocation (similar to how perl's require() function works). This
1338 helps avoid some difficult problems with dependency loops.
1339
1340 - Changed the documentation for the 'autosplit' parameter to give
1341 reasons why it may not be a good idea to use, but no longer
1342 threaten to remove it. [Suggested by Martyn J. Pearce]
1343
1344 - Improved the formatting of the 'traditional' Makefile.PL generated
1345 by Module::Build::Compat->create_makefile_pl. [Michael Schwern]
1346
1347 - The 'traditional' Makefile.PL will now use the 'module_name'
1348 parameter (as NAME) if it's available, otherwise it will continue
1349 to use the 'dist_name' (as DISTNAME). [Michael Schwern]
1350
1351 - Created read/write accessor methods for all our 'properties'.
1352 [Michael Schwern]
1353
1354 - The 'test_files' parameter can now be specified using glob() syntax
1355 (i.e. 't/*.t'), and the corresponding test_files() method is now a
1356 read/write accessor.
1357
1358 - The location of the 'blib' directory is now a property of the Build
1359 object - nobody is likely to notice this change, with any luck, but
1360 it makes the design and code cleaner.
1361
1362 - The 'disttest' and 'distsign' methods now chdir() back to the
1363 directory where they started, rather than to the base_dir of the
1364 build.
1365
1366 - Improved comparisons of version strings containing underscore
1367 characters (indicating "beta" status). [Steve Purkis]
1368
1369 - Added documentation for the 'dist_author', 'dist_abstract', and
1370 'codebase' parameters to new(), and for the 'ppd' action. [Dave
1371 Rolsky]
1372
1373 - Added documentation for the up_to_date() and contains_pod()
1374 methods. [Dave Rolsky]
1375
1376 - 'traditional' pass-through Makefile.PLs will now contain an
1377 INSTALLDIRS parameter matching the Build.PL's 'installdirs'
1378 setting.
1379
1380 - version_from_file() now ignores $VERSION variables that are defined
1381 in POD or comments. It can still be tricked by $VERSIONs in string
1382 literals, though. [Steve Purkis]
1383
1384 - The code to find packages in module files now uses Steve's scanning
1385 method (above) to skip package-declaration-lookalikes in POD or
1386 comments.
1387
1388 - The 'disttest' action will now propagate its @INC settings to its
1389 subprocesses.
1390
13910.19 Wed Jul 9 22:34:02 CDT 2003
1392
1393 - Added support for the 'install_path' parameter, which allows custom
1394 specification of where things should be installed. This is a major
1395 improvement to Module::Build's functionality.
1396
1397 - Added the 'install_base' parameter. Provides an easy way to
1398 install to local or alternative directory trees.
1399
1400 - We now install scripts by default to $Config{installsitebin}
1401 instead of $Config{installscript}. Neither is a great choice, but
1402 the former is likely to be [analogous to] /usr/local/bin, and the
1403 latter is likely to be [something like] /usr/bin . If/when there's
1404 a $Config{installsitescript}, we'll start using that automatically.
1405
1406 - Fixed a problem on Win32 in which C and XS files wouldn't be
1407 compiled properly, and the user would see an error about 'Can't
1408 locate object method "format_compiler_cmd"'.
1409 (http://rt.cpan.org/Ticket/Display.html?id=2391)
1410
1411 - We now use the correct perl interpreter (via
1412 Module::Build->find_perl_interpreter) in pass-through makefiles.
1413
1414 - The t/compat.t test now uses $Config{make} instead of just 'make'
1415 to test makefile compatibility. This fixes some failures on Win32.
1416 We also skip this test entirely if no make utility is available.
1417
1418 - Alternative distribution layouts are now supported via the
1419 'pm_files', 'pod_files', 'xs_files', 'PL_files', and 'script_files'
1420 parameters to new(). This should help people transition from
1421 MakeMaker, and might even help us write an automatic transition
1422 tool.
1423
1424 - Added tests to t/runthrough.t that check to see installation is
1425 happening correctly.
1426
1427 - Added experimental code to build a .ppd file, in support of
1428 ActiveState's "Perl Package Manager". [original patch by Dave
1429 Rolsky]
1430
1431 - For authors who use Module::Signature to sign their distributions,
1432 we now create the SIGNATURE file right in the distribution
1433 directory, rather than creating it in the top-level directory and
1434 copying it into place. This solves problems related to having
1435 files get out of date with respect to their signatures.
1436
1437 - We now don't depend on Module::Info to scan for packages during the
1438 'dist' action anymore, because it's way too aggressive about
1439 loading other modules that you may not want loaded. We now just
1440 (ick, yuck) scan the .pm files with a regular expression to find
1441 "package Foo::Bar;" statements.
1442
1443 - Silenced some annoying copyright/logo output from Microsoft 'nmake'
1444 during Makefile compatibility testing. [Randy W. Sims]
1445
1446 - Command-line arguments may now either be specified using the syntax
1447 '--foo foovalue' as well as the traditional syntax 'foo=foovalue'.
1448 The former is often more convenient for shell tab-completion when
1449 the value is a filename (as in 'Build test --test_files t/basic.t').
1450
1451 - Command-line arguments may now include non-named parameters, which
1452 make some actions more natural. For instance, the 'diff' action
1453 may now be invoked as 'Build diff -u' rather than as
1454 'Build diff flags=-u'.
1455
1456 - Pass-through Makefile.PLs now convert unknown Makefile.PL
1457 parameters to lower-case and hand them to Build.PL, rather than
1458 ignoring them. This means we only have to account for the
1459 differences in the interface, not the entire interface, in
1460 translating parameters.
1461
1462 - We now issue a warning & don't proceed if asked to make a distdir
1463 and there's no MANIFEST or it's empty.
1464
1465 - Moved INSTALL to INSTALL.txt to increase compatibility with various
1466 odd versions of 'make' during 'make install' on case-insensitive
1467 filesystems (like nmake on Win32, often). Only affects the
1468 Makefile compatibility layer. [reported by Andrew Savige]
1469
1470 - Module::Build->known_actions() now works as a class method.
1471
1472 - Pass-through makefiles now list each action individually rather
1473 than using a ".DEFAULT" catch-all. This improves compatibility
1474 with 'nmake' on Win32, and probably some other less common 'make'
1475 dialects. [Andrew Savige]
1476
1477 - We're now more aggressive about testing the pass-through makefiles,
1478 e.g. making sure they can run 'all' and 'test' targets, and making
1479 sure the Makefile itself actually exists.
1480
1481 - Fixed a problem with check_installed_status() when installed
1482 version contains non-numeric characters like underscores.
1483
1484 - Fixed a problem with a bareword 'File::Spec' in one of the test
1485 scripts that caused it not to compile under 5.8.0 (but is fine
1486 under 5.6).
1487
1488 - Fixed a problem with the 'destdir' installation parameter on
1489 platforms that have volume identifiers in path names (like "C:" on
1490 Win32). The identifier is now stripped from installation
1491 directories before prepending the destdir path. The destdir path
1492 may still have a volume identifier on it.
1493
1494 - Added an 'add_to_cleanup' parameter to new() that calls
1495 add_to_cleanup() immediately for the given files.
1496
1497 - The distribution directory (e.g. Sample-Module-0.13/ ) will now be
1498 deleted during the 'clean' or 'realclean' actions.
1499
1500 - During testing of modules, blib/lib and blib/arch are now added as
1501 absolute paths, not relative. This helps tests that load the
1502 modules at runtime and may change the current working directory
1503 (like Module::Build itself does during testing).
1504
1505 - The $Config{cc} entry on some people's systems is something like
1506 'ccache gcc', so we now split that string using split_like_shell().
1507 [Richard Clamp]
1508
1509 - Added documentation for 'extra_linker_flags' parameter, and added a
1510 corresponding 'extra_compiler_flags' parameter. [original patch by
1511 Richard Clamp]