.\" Automatically generated by Pod::Man v1.34, Pod::Parser v1.13
.\" ========================================================================
.de Sh \" Subsection heading
.de Sp \" Vertical space (when we can't use .PP)
.de Vb \" Begin verbatim text
.de Ve \" End verbatim text
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. | will give a
.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
.\" do unbreakable dashes and therefore won't be available. \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
. tm Index:\\$1\t\\n%\t"\\$2"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear. Run. Save yourself. No user-serviceable parts.
. \" fudge factors for nroff and troff
. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
. \" simple accents for nroff and troff
. ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
. ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
. ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
. ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
. ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
. \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
. \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
. \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
.\" ========================================================================
.IX Title "File::Spec::VMS 3"
.TH File::Spec::VMS 3 "2002-06-01" "perl v5.8.0" "Perl Programmers Reference Guide"
File::Spec::VMS \- methods for VMS file specs
\& require File::Spec::VMS; # Done internally by File::Spec if needed
See File::Spec::Unix for a documentation of the methods provided
there. This package overrides the implementation of these methods, not
.IX Item "eliminate_macros"
Expands MM[\s-1KS\s0]/Make macros in a text string, using the contents of
identically named elements of \f(CW%$self\fR, and returns the result
as a file specification in Unix syntax.
Catchall routine to clean up problem MM[\s-1SK\s0]/Make macros. Expands macros
in any directory specification, in order to avoid juxtaposing two
VMS-syntax directories when MM[\s-1SK\s0] is run. Also expands expressions which
are all macro, so that we can tell how long the expansion is, and avoid
overrunning \s-1DCL\s0's command buffer when MM[\s-1KS\s0] is running.
If optional second argument has a \s-1TRUE\s0 value, then the return string is
a VMS-syntax directory specification, if it is \s-1FALSE\s0, the return string
is a VMS-syntax file specification, and if it is not specified, \fIfixpath()\fR
checks to see whether it matches the name of a directory in the current
default directory, and returns a directory or file specification accordingly.
.Sh "Methods always loaded"
.IX Subsection "Methods always loaded"
.IP "canonpath (override)" 4
.IX Item "canonpath (override)"
Removes redundant portions of file specifications according to \s-1VMS\s0 syntax.
Concatenates a list of file specifications, and returns the result as a
VMS-syntax directory specification. No check is made for \*(L"impossible\*(R"
cases (e.g. elements other than the first being absolute filespecs).
Concatenates a list of file specifications, and returns the result as a
VMS-syntax file specification.
.IP "curdir (override)" 4
.IX Item "curdir (override)"
Returns a string representation of the current directory: '[]'
.IP "devnull (override)" 4
.IX Item "devnull (override)"
Returns a string representation of the null device: '_NLA0:'
.IP "rootdir (override)" 4
.IX Item "rootdir (override)"
Returns a string representation of the root directory: 'SYS$DISK:[000000]'
.IP "tmpdir (override)" 4
.IX Item "tmpdir (override)"
Returns a string representation of the first writable directory
from the following list or '' if none are writable:
Since perl 5.8.0, if running under taint mode, and if \f(CW$ENV\fR{\s-1TMPDIR\s0}
is tainted, it is not used.
.IX Item "updir (override)"
Returns a string representation of the parent directory: '[\-]'
.IP "case_tolerant (override)" 4
.IX Item "case_tolerant (override)"
\&\s-1VMS\s0 file specification syntax is case\-tolerant.
.IX Item "path (override)"
Translate logical name \s-1DCL$PATH\s0 as a searchlist, rather than trying
to \f(CW\*(C`split\*(C'\fR string value of \f(CW$ENV{'PATH'}\fR.
.IP "file_name_is_absolute (override)" 4
.IX Item "file_name_is_absolute (override)"
Checks for \s-1VMS\s0 directory spec as well as Unix separators.
.IP "splitpath (override)" 4
.IX Item "splitpath (override)"
Splits using \s-1VMS\s0 syntax.
.IP "splitdir (override)" 4
.IX Item "splitdir (override)"
Split dirspec using \s-1VMS\s0 syntax.
.IP "catpath (override)" 4
.IX Item "catpath (override)"
Construct a complete filespec using \s-1VMS\s0 syntax
.IP "abs2rel (override)" 4
.IX Item "abs2rel (override)"
Use \s-1VMS\s0 syntax when converting filespecs.
.IP "rel2abs (override)" 4
.IX Item "rel2abs (override)"
Use \s-1VMS\s0 syntax when converting filespecs.