redhat man page for file::spec::os2

File::Spec::OS2(3pm)					 Perl Programmers Reference Guide				      File::Spec::OS2(3pm)

       canonpath
	      No physical check on the filesystem, but a logical cleanup of a path. On UNIX eliminated successive slashes and successive "/.".

       splitpath
		  ($volume,$directories,$file) = File::Spec->splitpath( $path );
		  ($volume,$directories,$file) = File::Spec->splitpath( $path, $no_file );

       Splits a path in to volume, directory, and filename portions. Assumes that the last file is a path unless the path ends in '/', '/.', '/..'
       or $no_file is true.  On Win32 this means that $no_file true makes this return ( $volume, $path, undef ).

       Separators accepted are  and /.

       Volumes can be drive letters or UNC sharenames (\servershare).

       The results can be passed to "catpath" to get back a path equivalent to (usually identical to) the original path.

       splitdir
	      The opposite of catdir().

	   @dirs = File::Spec->splitdir( $directories );

       $directories must be only the directory portion of the path on systems that have the concept of a volume or that have path syntax that dif-
       ferentiates files from directories.

       Unlike just splitting the directories on the separator, leading empty and trailing directory entries can be returned, because these are
       significant on some OSs. So,

	   File::Spec->splitdir( "/a/b//c/" );

       Yields:

	   ( '', 'a', 'b', '', 'c', '' )

       catpath
	      Takes volume, directory and file portions and returns an entire path. Under Unix, $volume is ignored, and this is just like cat-
	      file(). On other OSs, the $volume become significant.

NAME
       File::Spec::OS2 - methods for OS/2 file specs

SYNOPSIS
	require File::Spec::OS2; # Done internally by File::Spec if needed

DESCRIPTION
       See File::Spec::Unix for a documentation of the methods provided there. This package overrides the implementation of these methods, not the
       semantics.

perl v5.8.0							    2002-06-01						      File::Spec::OS2(3pm)