X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FFile%2FSpec.pm;h=28379abf7649c80433681779b40cb7314446b269;hb=1158ce344e6265a869b839cb74dfea1138fd2130;hp=9aac374c138a5001d1cfbae7cff74aa01e508f40;hpb=23bb49fa8c98c39adab74ba793fe7dad073789c2;p=p5sagit%2Fp5-mst-13.2.git diff --git a/lib/File/Spec.pm b/lib/File/Spec.pm index 9aac374..28379ab 100644 --- a/lib/File/Spec.pm +++ b/lib/File/Spec.pm @@ -3,7 +3,7 @@ package File::Spec; use strict; use vars qw(@ISA $VERSION); -$VERSION = '3.17'; +$VERSION = '3.24'; $VERSION = eval $VERSION; my %module = (MacOS => 'Mac', @@ -83,6 +83,7 @@ forms of these methods. =over 2 =item canonpath +X No physical check on the filesystem, but a logical cleanup of a path. @@ -97,6 +98,7 @@ processing, you probably want C's C function to actually traverse the filesystem cleaning up paths like this. =item catdir +X Concatenate two or more directory names to form a complete path ending with a directory. But remove the trailing slash from the resulting @@ -107,6 +109,7 @@ trailing slash :-) $path = File::Spec->catdir( @directories ); =item catfile +X Concatenate one or more directory names and a filename to form a complete path ending with a filename @@ -114,24 +117,28 @@ complete path ending with a filename $path = File::Spec->catfile( @directories, $filename ); =item curdir +X Returns a string representation of the current directory. $curdir = File::Spec->curdir(); =item devnull +X Returns a string representation of the null device. $devnull = File::Spec->devnull(); =item rootdir +X Returns a string representation of the root directory. $rootdir = File::Spec->rootdir(); =item tmpdir +X Returns a string representation of the first writable directory from a list of possible temporary directories. Returns the current directory @@ -142,6 +149,7 @@ checked depends on the platform; e.g. File::Spec::Unix checks C<$ENV{TMPDIR}> $tmpdir = File::Spec->tmpdir(); =item updir +X Returns a string representation of the parent directory. @@ -172,6 +180,7 @@ Mac OS (Classic). It does consult the working environment for VMS (see L). =item path +X Takes no argument. Returns the environment variable C (or the local platform's equivalent) as a list. @@ -179,10 +188,12 @@ platform's equivalent) as a list. @PATH = File::Spec->path(); =item join +X join is the same as catfile. =item splitpath +X X Splits a path in to volume, directory, and filename portions. On systems with no concept of volume, returns '' for volume. @@ -201,6 +212,7 @@ The results can be passed to L to get back a path equivalent to (usually identical to) the original path. =item splitdir +X X The opposite of L. @@ -223,6 +235,7 @@ inserted if need be. On other OSes, C<$volume> is significant. $full_path = File::Spec->catpath( $volume, $directory, $file ); =item abs2rel +X X X Takes a destination path and an optional base path returns a relative path from the base path to the destination path: @@ -255,6 +268,7 @@ macros are expanded. Based on code written by Shigio Yamaguchi. =item rel2abs() +X X X Converts a relative path to an absolute path.