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