1 Revision history for Perl distribution PathTools.
3 3.14_01 Fri Dec 9 22:45:49 CST 2005
5 - The Cwd::getcwd() function on *nix is now a direct pass-through to
6 the underlying getcwd() C library function when possible. This is
7 safer and faster than the previous implementation, which just did
8 abs_path('.'). [Suggested by Nick Ing-Simmons]
10 - When Cwd searches for a 'pwd' executable in the $PATH, we now stop
11 after we find the first one rather than continuing the search. We
12 also avoid the $PATH search altogether when a 'pwd' was already
13 found in a well-known and well-trusted location like /bin or
14 /usr/bin. [Suggested by Nick Ing-Simmons]
16 - On Win32 abs2rel($path, $base) was failing whenever $base is the
17 root of a volume (such as C:\ or \\share\dir). This has been
18 fixed. [Reported by Bryan Daimler]
20 - In abs2rel() on VMS, we've fixed handling of directory trees so
21 that the test $file = File::Spec::VMS->abs2rel('[t1.t2.t3]file',
22 '[t1.t2.t3]') returns 'file' instead of an empty string. [John
25 - In canonpath() on VMS, '[]' was totally optimized away instead of
26 just returning '[]'. Now it's fixed. [John E. Malmberg]
28 3.14 Thu Nov 17 18:08:44 CST 2005
30 - canonpath() has some logic in it that avoids collapsing a
31 //double/slash at the beginning of a pathname on platforms where
32 that means something special. It used to check the value of $^O
33 rather than the classname it was called as, which meant that
34 calling File::Spec::Cygwin->canonpath() didn't act like cygwin
35 unless you were actually *on* cygwin. Now it does.
37 - Fixed a major bug on Cygwin in which catdir() could sometimes
38 create things that look like //network/paths in cases when it
39 shouldn't (e.g. catdir("/", "foo", "bar")).
41 3.13 Tue Nov 15 23:50:37 CST 2005
43 - Calling tmpdir() on Win32 had the unintended side-effect of storing
44 some undef values in %INC for the TMPDIR, TEMP, and TMP entries if
45 they didn't exist already. This is probably a bug in perl itself
46 (submitted as #37441 on rt.perl.org), which we're now working
47 around. [Thomas L. Shinnick]
49 - Integrated a change from bleadperl - a certain #ifdef in Cwd.xs
50 needs to apply to WIN32 but not WinCE. [Vadim Konovalov]
52 - abs2rel() used to return the empty string when its two arguments
53 were identical, which made no sense. Now it returns
54 curdir(). [Spotted by David Golden]
56 - The Unix and Win32 implementations of abs2rel() have been unified.
58 3.12 Mon Oct 3 22:09:12 CDT 2005
60 - Fixed a testing error on OS/2 in which a drive letter for the root
61 directory was confusing things. [Ilya Zakharevich]
63 - Integrated a patch from bleadperl for fixing path() on
66 3.11 Sat Aug 27 20:12:55 CDT 2005
68 - Fixed a couple of typos in the documentation for
69 File::Spec::Mac. [Piotr Fusik]
71 3.10 Thu Aug 25 22:24:57 CDT 2005
73 - eliminate_macros() and fixpath() in File::Spec::VMS are now
74 deprecated, since they are MakeMaker-specific and now live inside
75 MakeMaker. [Michael Schwern]
77 - canonpath() on Win32 now collapses foo/.. (or foo\..) sections
78 correctly, rather than doing the "misguided" work it was previously
79 doing. Note that canonpath() on Unix still does NOT collapse these
80 sections, as doing so would be incorrect. [Michael Schwern]
82 3.09 Tue Jun 14 20:36:50 CDT 2005
84 - Added some block delimiters (brackets) in the Perl_getcwd_sv() XS
85 function, which were necessary to separate the variable
86 declarations from the statements when HAS_GETCWD is not
89 - Apparently the _NT_cwd() routine is never defined externally like I
90 thought it was, so I simplified the code around it.
92 - When cwd() is implemented using the _backtick_pwd() function, it
93 sometimes could create accidental undef entries in %ENV under perl
94 5.6, because local($hash{key}) is somewhat broken. This is now
95 fixed with an appropriate workaround. [Neil Watkiss]
97 3.08 Sat May 28 10:10:29 CDT 2005
99 - Fixed a test failure with fast_abs_path() on Windows - it was
100 sensitive to the rootdir() change from version 3.07. [Steve Hay]
102 3.07 Fri May 6 07:46:45 CDT 2005
104 - Fixed a bug in which the special perl variable $^O would become
105 tainted under certain versions of perl. [Michael Schwern]
107 - File::Spec->rootdir() was returning / on Win32. Now it returns \ .
110 - We now avoid modifying @_ in tmpdir() when it's not strictly
111 necessary, which reportedly provides a modest performance
112 boost. [Richard Soderberg]
114 - Made a couple of slight changes to the Win32 code so that it works
115 (or works better) on Symbian OS phones. [Jarkko Hietaniemi]
117 3.06 Wed Apr 13 20:47:26 CDT 2005
119 (No changes in functionality)
121 - Added a note to the canonpath() docs about why it doesn't collapse
124 - The internal-only function bsd_realpath() in the XS file now uses
125 normal arg syntax instead of K&R syntax. [Nicholas Clark]
127 3.05 Mon Feb 28 07:22:58 CST 2005
129 - Fixed a bug in fast_abs_path() on Win32 in which forward- and
130 backward-slashes were confusing things. [demerphq]
132 - Failure to load the XS code in Cwd is no longer a fatal error
133 (though failure to compile it is still a fatal error in the build
134 process). This lets Cwd work under miniperl in the core. [Rafael
137 - In the t/cwd.t test, don't enforce loading from blib/ if we're
138 testing in the perl core. [Rafael Garcia-Suarez]
140 3.04 Sun Feb 6 17:27:38 CST 2005
142 - For perls older than 5.006, the HAS_GETCWD symbol is not available,
143 because it wasn't checked for in older Configure scripts when perl
144 was built. We therefore just ask the user whether the getcwd() C
145 function is defined on their platform when their perl is old.
146 Maybe in the future we'll try to automate this. [Reported by
149 - Remove lib/ppport.h from the distribution, so that MakeMaker
150 doesn't accidentally pick it up and install it as a lib
153 - Fixed a testing error on VMS that occurred when a user had
154 read-access to the root of the current volume. [Craig A. Berry]
156 3.03 Fri Jan 21 21:44:05 CST 2005
158 - Fixed a testing error if the first file we find in the root
159 directory is a symlink. [Blair Zajac]
161 - Added a test to make sure Cwd.pm is loaded from blib/ during
162 testing, which seems to be an issue in some people's environments
163 and makes it awfully hard to debug things on my end.
165 - Skip the _perl_abs_path() tests on Cygwin - they don't usually
166 pass, and this function isn't used there anyway, so I decided not
167 to push it. Let 'em use `cwd`.
169 3.02 Sun Jan 9 19:29:52 CST 2005
171 - Fixed a bug in which Cwd::abs_path() called on a file in the root
172 directory returned strange results. [Bob Luckin]
174 - Straightened out the licensing details for the portion of the Cwd
175 module that comes from BSD sources. [Hugo van der Sanden]
177 - Removed the prototype from _perl_abs_path() and the XS version of
178 abs_path(), since all they seemed to be doing was causing people
179 grief, and since some platforms didn't have them anyway.
181 - Fixed a testing bug in which sometimes the wrong version of Cwd
182 (the version already installed on the user's machine) would get
183 loaded instead of the one we're building & installing.
185 - Sometimes getdcwd() returns a lower-case drive letter, so don't
186 require an upper-case letter in t/win32.t. [Jan Dubois]
188 - Fixed a memory leak in getdcwd() on win32. [Steve Hay]
190 - Added a copy of ppport.h to the distribution to aid compilation on
191 older versions of perl. [Suggested by Charlie Root]
193 - Don't bother looking for a 'pwd' executable on MSWin32 - there
194 won't be one, and looking for it can be extremely slow when lots of
195 disks are mounted. [Several people, including Andrew Burke]
197 - Eliminated a multi-argument form of open() that was causing a
198 syntax error on older versions of perl. [Fixed by Michael Schwern]
200 - The bug-fix changes for revision 0.90 of File::Spec somehow were
201 lost when I merged it into the PathTools distribution. They're
202 restored now. [Craig A. Berry]
204 - File::Spec->canonpath() will now reduce paths like '[d1.-]foo.dat'
205 down to '[000000]foo.dat' instead of '[]foo.dat' or 'foo.dat'.
206 This is in better accordance with the native filename syntax
207 parser. [Craig A. Berry]
209 - In order to remove a recursive dependency (PathTools -> Test-Simple
210 -> Test-Harness -> PathTools), we now include a copy of Test::More in
211 the distribution. It is only used for testing, it won't be installed
212 with the rest of the stuff.
214 - Removed some 5.6-isms from Cwd in order to get it to build with
215 older perls like 5.005.
217 - abs_path() on Windows was trampling on $ENV{PWD} - fixed. [Spotted
220 - Added licensing/copyright statements to the POD in each .pm
221 file. [Spotted by Radoslaw Zielinski]
223 3.01 Mon Sep 6 22:28:06 CDT 2004
225 - Removed an unnecessary and confusing dependency on File::Spec from
226 the Makefile.PL and the Build.PL.
228 - Added a 'NAME' entry to the Makefile.PL, because otherwise it won't
229 even begin to work. [Reported by many]
231 3.00 Thu Sep 2 22:15:07 CDT 2004
233 - Merged Cwd and File::Spec into a single PathTools distribution.
234 This was done because the two modules use each other fairly
235 extensively, and extracting the common stuff into another
236 distribution was deemed nigh-impossible. The code in revision 3.00
237 of PathTools should be equivalent to the code in Cwd 2.21 and
240 ==================================================================
241 Prior to revision 3.00, Cwd and File::Spec were maintained as two
242 separate distributions. The revision history for Cwd is shown here.
243 The revision history for File::Spec is further below.
244 ==================================================================
246 Cwd 2.21 Tue Aug 31 22:50:14 CDT 2004
248 - Removed "NO_META" from the Makefile.PL, since I'm not building the
249 distribution with MakeMaker anyway. [Rohan Carly]
251 - Only test _perl_abs_path() on platforms where it's expected to work
252 (platforms with '/' as the directory separator). [Craig A. Berry]
254 Cwd 2.20 Thu Jul 22 08:23:53 CDT 2004
256 - On some implementations of perl on Win32, a memory leak (or worse?)
257 occurred when calling getdcwd(). This has been fixed. [PodMaster]
259 - Added tests for getdcwd() on Win32.
261 - Fixed a problem in the pure-perl implementation _perl_abs_path()
262 that caused a fatal error when run on plain files. [Nicholas Clark]
263 To exercise the appropriate test code on platforms that wouldn't
264 otherwise use _perl_abs_path(), run the tests with $ENV{PERL_CORE}
265 or $ENV{TEST_PERL_CWD_CODE} set.
267 Cwd 2.19 Thu Jul 15 08:32:18 CDT 2004
269 - The abs_path($arg) fix from 2.18 didn't work for VMS, now it's
270 fixed there. [Craig Berry]
272 Cwd 2.18 Thu Jun 24 08:22:57 CDT 2004
274 - Fixed a problem in which abs_path($arg) on some platforms could
275 only be called on directories, and died when called on files. This
276 was a problem in the pure-perl implementation _perl_abs_path().
278 - Fixed fast_abs_path($arg) in the same way as abs_path($arg) above.
280 - On Win32, a function getdcwd($vol) has been added, which gets the
281 current working directory of the specified drive/volume.
284 - Fixed a problem on perl 5.6.2 when built with the MULTIPLICITY
285 compile-time flags. [Yitzchak Scott-Thoennes]
287 - When looking for a `pwd` system command, we no longer assume the
288 path separator is ':'.
290 - On platforms where cwd() is implemented internally (like Win32),
291 don't look for a `pwd` command externally. This can greatly speed
292 up load time. [Stefan Scherer]
294 - The pure-perl version of abs_path() now has the same prototype as
297 Cwd 2.17 Wed Mar 10 07:55:36 CST 2004
299 - The change in 2.16 created a testing failure when tested from
300 within a path that contains symlinks (for instance, /tmp ->
303 Cwd 2.16 Sat Mar 6 17:56:31 CST 2004
305 - For VMS compatibility (and to conform to Cwd's documented
306 interface), in the regression tests we now compare output results
307 to an absolute path. [Craig A. Berry]
309 Cwd 2.15 Fri Jan 16 08:09:44 CST 2004
311 - Fixed a problem on static perl builds - while creating
312 Makefile.aperl, it was loading a mismatched version of Cwd from
313 blib/ . [Reported by Blair Zajac]
315 Cwd 2.14 Thu Jan 8 18:51:08 CST 2004
317 - We now use File::Spec->canonpath() and properly-escaped regular
318 expressions when comparing paths in the regression tests. This
319 fixes some testing failures in 2.13 on non-Unix platforms. No
320 changes were made in the actual Cwd module code. [Steve Hay]
322 Cwd 2.13 Fri Jan 2 22:29:42 CST 2004
324 - Changed a '//' comment to a '/* */' comment in the XS code, so that
325 it'll compile properly under ANSI C rules. [Jarkko Hietaniemi]
327 - Fixed a 1-character buffer overrun problem in the C code. [The BSD
330 Cwd 2.12 Fri Dec 19 17:04:52 CST 2003
332 - Fixed a bug on Cygwin - the output of realpath() should have been
333 tainted, but wasn't. [Reported by Tom Wyant]
335 Cwd 2.10 Mon Dec 15 07:50:12 CST 2003
337 (Note that this release was mistakenly packaged as version 2.11, even
338 though it had an internal $VERSION variable of 2.10. Not sure how
341 - There was a dependency in the Makefile.PL on Module::Build, which
342 isn't necessary. I've removed it.
344 Cwd 2.09 Thu Dec 11 20:30:58 CST 2003
346 - The module should now build & install using version 5.6 of perl.
348 - We now note a build-time dependency on version 0.19 of
349 Module::Build, which is necessary because we don't use the standard
350 lib/-based file layout. No version of Module::Build is required if
351 you use the Makefile.PL, just if you use the Build.PL .
353 - Removed some gratuitous uses of 5.6-isms like our(), with the aim
354 of backporting this module to perl 5.005.
356 - Simplified all code that autoloads Carp.pm and calls
359 - Removed some redundant OS/2 code at the suggestion of Michael
360 Schwern and Ilya Zakharevich.
362 - Make sure the correct version of Cwd.pm is loaded in the regression
365 Cwd 2.08 Wed Oct 15 20:56 CDT 2003
367 - Code extracted from perl 5.8.1 and packaged as a separate CPAN
368 release by Ken Williams.
370 ==================================================================
371 Prior to revision 3.00, Cwd and File::Spec were maintained as two
372 separate distributions. The revision history for File::Spec is shown
373 here. The revision history for Cwd is above.
374 ==================================================================
376 File::Spec 0.90 Tue Aug 31 22:34:50 CDT 2004
378 - On VMS, directories use vmspath() and files use vmsify(), so
379 rel2abs() has to use some 'educated guessing' when dealing with
380 paths containing slashes. [Craig A. Berry]
382 File::Spec 0.89 Sun Aug 29 19:02:32 CDT 2004
384 - Fixed some pathological cases on VMS which broke canonpath() and
385 splitdir(). [Richard Levitte and Craig A. Berry]
387 - Fixed rel2abs() on VMS when passed a unix-style relative
388 path. [Craig A. Berry]
390 File::Spec 0.88 Thu Jul 22 23:14:32 CDT 2004
392 - rel2abs() on Win32 will now use the new Cwd::getdcwd() function, so
393 that things like rel2abs('D:foo.txt') work properly when the
394 current drive isn't 'D'. This requires Cwd version 2.18.
397 - Got rid of a redundant double-backslash in a character
398 class. [Alexander Farber]
400 - Added much markup to pod for enhanced readability. [Andy Lester]
402 File::Spec 0.87 Fri Dec 19 08:03:28 CST 2003
404 - With a one-line change in the tests, backported to perl 5.004.
405 [Issue reported by Barry Kemble]
407 File::Spec 0.86 Fri Sep 26 10:07:39 CDT 2003
409 - This is the version released with perl 5.8.1. It is identical to
410 the code in the File::Spec beta 0.85_03.
412 File::Spec 0.85_03 Mon Sep 15 09:35:53 CDT 2003
414 - On VMS, if catpath() receives volume specifiers in both its first
415 two arguments, it will now use the volume in the first argument
416 only. Previously it returned a non-syntactical result which
417 included both volumes. This change is the same in spirit to the
418 catpath() MacOS change from version 0.85_02.
420 - Fixed an abs2rel() bug on VMS - previously
421 abs2rel('[t1.t2.t3]file','[t1.t2]') returned '[t3]file', now it
422 properly returns '[.t3]file'.
424 File::Spec 0.85_02 Fri Sep 12 17:11:13 CDT 2003
426 - abs2rel() now behaves more consistently across platforms with the
427 notion of a volume. If the volumes of the first and second
428 argument (the second argument may be implicit) do not agree, we do
429 not attempt to reconcile the paths, and simply return the first
430 argument. Previously the volume of the second argument was
431 (usually) ignored, resulting in sometimes-garbage output.
433 - catpath() on MacOS now looks for a volume element (i.e. "Macintosh HD:")
434 in its first argument, and then its second argument. The first
435 volume found will be used, and if none is found, none will be used.
437 - Fixed a problem in abs2rel() on Win32 in which the volume of the
438 current working directory would get added to the second argument if
439 none was specified. This might have been somewhat helpful, but it
440 was contrary to the documented behavior. For example,
441 abs2rel('C:/foo/bar', '/foo') used to return 'bar', now it returns
442 'C:/foo/bar' because there's no guarantee /foo is actually C:/foo .
444 - catdir('/', '../') on OS2 previously erroneously returned '//..',
445 and now it returns '/'.
447 File::Spec 0.85_01 Thu Sep 11 16:18:54 CDT 2003
449 Working toward 0.86, the version that will be released with perl 5.8.1.
451 - The t/rel2abs2rel.t test now is a little friendlier about emitting
452 its diagnostic debugging output. [Jarkko Hietaniemi]
454 - We now only require() Cwd when it's needed, on demand. [Michael
457 - Fixed some POD errors and redundancies in OS2.pm and Cygwin.pm.
460 - The internal method cwd() has been renamed to _cwd(), since it was
461 never meant for public use. [Michael Schwern]
463 - Several methods in File::Spec::Unix that just return constant
464 strings have been sped up. catdir() has also been sped up there.
467 - Several canonpath() and catdir() bugs on Win32 have been fixed, and
468 tests added for them:
469 catdir('/', '../') -> '\\' (was '\..')
470 catdir('/', '..\\') -> '\\ (was '')
471 canonpath('\\../') -> '\\' (was '')
472 canonpath('\\..\\') -> '\\' (was '')
473 canonpath('/../') -> '\\' (was '\..')
474 canonpath('/..\\') -> '\\' (was '')
475 catdir('\\', 'foo') -> '\foo' (was '\\foo')
477 - catpath($volume, $dirs, $file) on Mac OS now ignores any volume
478 that might be part of $dirs, enabling catpath($volume,
479 catdir(rootdir(), 'foo'), '') to work portably across platforms.
481 File::Spec 0.85 Tue Jul 22 11:31 CDT 2003
483 A bug-fix release relative to 0.84. I've forked development into a
484 "stable" branch (this one) and a more aggressive branch (as yet
485 unreleased), with an eye toward getting the stable features in perl
488 - File::Spec::Mac->case_tolerant() returned 0 when it should have
491 - Many cases in File::Spec::Win32->abs2rel() were broken, because of
492 the way in which volumes were/weren't ignored. Unfortunately, part
493 of the regression tests were broken too. Now, if the $path
494 argument to abs2rel() is on a different volume than the $base
495 argument, the result will be an absolute path rather than the
496 broken relative path previous versions returned.
498 - Fixed a problem in File::Spec::Win32->canonpath, which was turning
499 \../foo into "foo" rather than \foo
501 - Greatly simplified the code in File::Spec::Unix->splitdir().
503 File::Spec 0.84_01 Fri Jul 11 16:14:29 CDT 2003
505 No actual code changes, just changes in other distribution files
507 - Dependencies are now listed explicitly in the Makefile.PL and
508 Build.PL scripts, as well as in the META.yml file.
510 - The t/abs2rel2abs.t test should now be more friendly about skipping
511 on platforms where it can't run properly.
513 File::Spec 0.84 Wed Jul 9 22:21:23 CDT 2003
515 I (Ken)'ve taken the changes from bleadperl and created a new CPAN release
516 from them, since they're pretty important changes. The highlights,
517 from what I can tell, are listed here.
519 - A huge number of changes to File::Spec::Mac in order to bring it in
520 line with the other platforms. This work was mostly/completely
521 done by Thomas Wegner.
523 - The Epoc and Cygwin platforms are now supported.
525 - Lots of generically-applicable documentation has been taken from
526 File::Spec::Unix and put in File::Spec.
528 - A Build.PL has been provided for people who wish to install via
531 - Some spurious warnings and errors in the tests have been
532 eliminated. [Michael Schwern]
534 - canonpath() on File::Spec::Unix now honors a //node-name at the
537 - Cwd.pm wasn't being loaded properly on MacOS. [Chris Nandor]
541 - Several testing patches for the Epoc and Cygwin platforms [Tels]
543 - When running under taint mode and perl >= 5.8, all the tmpdir()
544 implementations now avoid returning a tainted path.
546 - File::Spec::OS2 now implements canonpath(), splitpath(),
547 splitdir(), catpath(), abs2rel(), and rel2abs() directly rather
548 than inheriting them from File::Spec::Unix.
550 - Added 'SYS:/temp' and 'C:/temp' to the list of possible tmpdir()s
553 - catfile() on Win32 and VMS will now automatically call canonpath()
554 on its final argument.
556 - canonpath() on Win32 now does a much more extensive cleanup of the
559 - abs2rel() on Win32 now defaults to using cwd() as the base of
560 relativity when no base is given.
562 - abs2rel() on Win32 now explicitly ignores any volume component in
565 - canonpath() on VMS now does []foo ==> foo, and foo.000000] ==> foo].
566 It also fixes a bug in multiple [000000.foo ==> [foo translations.
568 - tmpdir() on VMS now uses 'sys$scratch:' instead of 'sys$scratch'.
570 - abs2rel() on VMS now uses '000000' in both the path and the base.
572 File::Spec 0.82 Wed Jun 28 11:24:05 EDT 2000
573 - Mac.pm: file_name_is_absolute( '' ) now returns TRUE on all platforms
574 - Spec.pm: unbreak C<$VERSION = '0.xx'> to be C<$VERSION = 0.xx>, so
575 underscores can be used when I want to update CPAN without anyone
576 needing to update the perl repository.
577 - abs2rel, rel2abs doc tweaks
578 - VMS.pm: get $path =~ /\s/ checks from perl repository.
579 - Makefile.PL: added INSTALLDIRS => 'perl', since these are std. modules.
580 - Remove vestigial context prototypes from &rel2abs until some future
581 arrives where method prototypes are honored.