<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">package File::Spec;

use strict;
use vars qw(@ISA $VERSION);

$VERSION = 0.82 ;

my %module = (MacOS   =&gt; 'Mac',
	      MSWin32 =&gt; 'Win32',
	      os2     =&gt; 'OS2',
	      VMS     =&gt; 'VMS',
	      epoc    =&gt; 'Epoc');

my $module = $module{$^O} || 'Unix';
require "File/Spec/$module.pm";
@ISA = ("File::Spec::$module");

1;
__END__

=head1 NAME

File::Spec - portably perform operations on file names

=head1 SYNOPSIS

	use File::Spec;

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

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

	use File::Spec::Functions;

	$x = catfile('a', 'b', 'c');

=head1 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 KE&lt;ouml&gt;nig, 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 facilities available
only under that OS, 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-&gt;catfile('a','b');

For simple uses, L&lt;File::Spec::Functions&gt; provides convenient functional
forms of these methods.

For a list of available methods, please consult L&lt;File::Spec::Unix&gt;,
which contains the entire set, and which is inherited by the modules for
other platforms. For further information, please see L&lt;File::Spec::Mac&gt;,
L&lt;File::Spec::OS2&gt;, L&lt;File::Spec::Win32&gt;, or L&lt;File::Spec::VMS&gt;.

=head1 SEE ALSO

File::Spec::Unix, File::Spec::Mac, File::Spec::OS2, File::Spec::Win32,
File::Spec::VMS, File::Spec::Functions, ExtUtils::MakeMaker

=head1 AUTHORS

Kenneth Albanowski &lt;F&lt;kjahds@kjahds.com&gt;&gt;, Andy Dougherty
&lt;F&lt;doughera@lafcol.lafayette.edu&gt;&gt;, Andreas KE&lt;ouml&gt;nig
&lt;F&lt;A.Koenig@franz.ww.TU-Berlin.DE&gt;&gt;, Tim Bunce &lt;F&lt;Tim.Bunce@ig.co.uk&gt;&gt;. VMS
support by Charles Bailey &lt;F&lt;bailey@newman.upenn.edu&gt;&gt;.  OS/2 support by
Ilya Zakharevich &lt;F&lt;ilya@math.ohio-state.edu&gt;&gt;. Mac support by Paul Schinder
&lt;F&lt;schinder@pobox.com&gt;&gt;.  abs2rel() and rel2abs() written by
Shigio Yamaguchi &lt;F&lt;shigio@tamacom.com&gt;&gt;, modified by Barrie Slaymaker
&lt;F&lt;barries@slaysys.com&gt;&gt;.  splitpath(), splitdir(), catpath() and catdir()
by Barrie Slaymaker.
</pre></body></html>