File::Spec(3)

NAME
     File::Spec - portably perform operations on file names

SYNOPSIS
     use File::Spec;

     $x=File::Spec->catfile('a','b','c');

     which returns 'a/b/c' under Unix.

DESCRIPTION
     This module is designed to support operations commonly performed on file
     specifications (usually called "file names", but not to be confused with
     the contents of a file, or Perl's file handles), such as concatenating
     several directory and file names into a single path, or determining
     whether a path is rooted. It is based on code directly taken from
     MakeMaker 5.17, code written by Andreas Koenig, Andy Dougherty, Charles
     Bailey, Ilya Zakharevich, Paul Schinder, and others.

     Since these functions are different for most operating systems, each set
     of OS specific routines is available in a separate module, including:

             File::Spec::Unix
             File::Spec::Mac
             File::Spec::OS2
             File::Spec::Win32
             File::Spec::VMS

     The module appropriate for the current OS is automatically loaded by
     File::Spec. Since some modules (like VMS) make use of OS specific
     facilities, it may not be possible to load all modules under all
     operating systems.

     Since File::Spec is object oriented, subroutines should not called
     directly, as in:

             File::Spec::catfile('a','b');

     but rather as class methods:

             File::Spec->catfile('a','b');

     For a reference of available functions, pleaes consult the
     File::Spec::Unix manpage, which contains the entire set, and inherited by
     the modules for other platforms. For further information, please see the
     File::Spec::Mac manpage, the File::Spec::OS2 manpage, the
     File::Spec::Win32 manpage, or the File::Spec::VMS manpage.

SEE ALSO
     File::Spec::Unix, File::Spec::Mac, File::Spec::OS2, File::Spec::Win32,
     File::Spec::VMS, ExtUtils::MakeMaker
AUTHORS
     Kenneth Albanowski <kjahds@kjahds.com>, Andy Dougherty
     <doughera@lafcol.lafayette.edu>, Andreas Koenig
     <A.Koenig@franz.ww.TU-Berlin.DE>, Tim Bunce <Tim.Bunce@ig.co.uk>. VMS
     support by Charles Bailey <bailey@newman.upenn.edu>.  OS/2 support by
     Ilya Zakharevich <ilya@math.ohio-state.edu>. Mac support by Paul Schinder
     <schinder@pobox.com>.