local-lib5/man/man3/Module::Build::Platform::VMS.3pm

   1 .\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.3
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sh \" Subsection heading
   6 .br
   7 .if t .Sp
   8 .ne 5
   9 .PP
  10 \fB\\$1\fR
  11 .PP
  12 ..
  13 .de Sp \" Vertical space (when we can't use .PP)
  14 .if t .sp .5v
  15 .if n .sp
  16 ..
  17 .de Vb \" Begin verbatim text
  18 .ft CW
  19 .nf
  20 .ne \\$1
  21 ..
  22 .de Ve \" End verbatim text
  23 .ft R
  24 .fi
  25 ..
  26 .\" Set up some character translations and predefined strings.  \*(-- will
  27 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  28 .\" double quote, and \*(R" will give a right double quote.  | will give a
  29 .\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
  30 .\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
  31 .\" expand to `' in nroff, nothing in troff, for use with C<>.
  32 .tr \(*W-|\(bv\*(Tr
  33 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  34 .ie n \{\
  35 .    ds -- \(*W-
  36 .    ds PI pi
  37 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  38 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  39 .    ds L" ""
  40 .    ds R" ""
  41 .    ds C` ""
  42 .    ds C' ""
  43 'br\}
  44 .el\{\
  45 .    ds -- \|\(em\|
  46 .    ds PI \(*p
  47 .    ds L" ``
  48 .    ds R" ''
  49 'br\}
  50 .\"
  51 .\" If the F register is turned on, we'll generate index entries on stderr for
  52 .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
  53 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  54 .\" output yourself in some meaningful fashion.
  55 .if \nF \{\
  56 .    de IX
  57 .    tm Index:\\$1\t\\n%\t"\\$2"
  58 ..
  59 .    nr % 0
  60 .    rr F
  61 .\}
  62 .\"
  63 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
  64 .\" way too many mistakes in technical documents.
  65 .hy 0
  66 .if n .na
  67 .\"
  68 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  69 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  70 .    \" fudge factors for nroff and troff
  71 .if n \{\
  72 .    ds #H 0
  73 .    ds #V .8m
  74 .    ds #F .3m
  75 .    ds #[ \f1
  76 .    ds #] \fP
  77 .\}
  78 .if t \{\
  79 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  80 .    ds #V .6m
  81 .    ds #F 0
  82 .    ds #[ \&
  83 .    ds #] \&
  84 .\}
  85 .    \" simple accents for nroff and troff
  86 .if n \{\
  87 .    ds ' \&
  88 .    ds ` \&
  89 .    ds ^ \&
  90 .    ds , \&
  91 .    ds ~ ~
  92 .    ds /
  93 .\}
  94 .if t \{\
  95 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
  96 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
  97 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
  98 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
  99 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 100 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 101 .\}
 102 .    \" troff and (daisy-wheel) nroff accents
 103 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 104 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 105 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 106 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 107 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 108 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 109 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 110 .ds ae a\h'-(\w'a'u*4/10)'e
 111 .ds Ae A\h'-(\w'A'u*4/10)'E
 112 .    \" corrections for vroff
 113 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 114 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 115 .    \" for low resolution devices (crt and lpr)
 116 .if \n(.H>23 .if \n(.V>19 \
 117 \{\
 118 .    ds : e
 119 .    ds 8 ss
 120 .    ds o a
 121 .    ds d- d\h'-1'\(ga
 122 .    ds D- D\h'-1'\(hy
 123 .    ds th \o'bp'
 124 .    ds Th \o'LP'
 125 .    ds ae ae
 126 .    ds Ae AE
 127 .\}
 128 .rm #[ #] #H #V #F C
 129 .\" ========================================================================
 130 .\"
 131 .IX Title "Module::Build::Platform::VMS 3"
 132 .TH Module::Build::Platform::VMS 3 "2009-12-09" "perl v5.8.7" "User Contributed Perl Documentation"
 133 .SH "NAME"
 134 Module::Build::Platform::VMS \- Builder class for VMS platforms
 135 .SH "DESCRIPTION"
 136 .IX Header "DESCRIPTION"
 137 This module inherits from \f(CW\*(C`Module::Build::Base\*(C'\fR and alters a few
 138 minor details of its functionality.  Please see Module::Build for
 139 the general docs.
 140 .Sh "Overridden Methods"
 141 .IX Subsection "Overridden Methods"
 142 .IP "_set_defaults" 4
 143 .IX Item "_set_defaults"
 144 Change \f(CW$self\fR\->{build_script} to 'Build.com' so \f(CW@Build\fR works.
 145 .IP "cull_args" 4
 146 .IX Item "cull_args"
 147 \&'@Build foo' on \s-1VMS\s0 will not preserve the case of 'foo'.  Rather than forcing
 148 people to write '@Build \*(L"foo\*(R"' we'll dispatch case\-insensitively.
 149 .IP "manpage_separator" 4
 150 .IX Item "manpage_separator"
 151 Use '_\|_' instead of '::'.
 152 .IP "prefixify" 4
 153 .IX Item "prefixify"
 154 Prefixify taking into account \s-1VMS\s0' filepath syntax.
 155 .IP "_quote_args" 4
 156 .IX Item "_quote_args"
 157 Command-line arguments (but not the command itself) must be quoted
 158 to ensure case preservation.
 159 .IP "have_forkpipe" 4
 160 .IX Item "have_forkpipe"
 161 There is no native \fIfork()\fR, so some constructs depending on it are not
 162 available.
 163 .IP "_backticks" 4
 164 .IX Item "_backticks"
 165 Override to ensure that we quote the arguments but not the command.
 166 .IP "do_system" 4
 167 .IX Item "do_system"
 168 Override to ensure that we quote the arguments but not the command.
 169 .IP "oneliner" 4
 170 .IX Item "oneliner"
 171 Override to ensure that we do not quote the command.
 172 .IP "_infer_xs_spec" 4
 173 .IX Item "_infer_xs_spec"
 174 Inherit the standard version but tweak the library file name to be
 175 something Dynaloader can find.
 176 .IP "rscan_dir" 4
 177 .IX Item "rscan_dir"
 178 Inherit the standard version but remove dots at end of name.
 179 If the extended character set is in effect, do not remove dots from filenames
 180 with Unix path delimiters.
 181 .IP "dist_dir" 4
 182 .IX Item "dist_dir"
 183 Inherit the standard version but replace embedded dots with underscores because
 184 a dot is the directory delimiter on \s-1VMS\s0.
 185 .IP "man3page_name" 4
 186 .IX Item "man3page_name"
 187 Inherit the standard version but chop the extra manpage delimiter off the front if
 188 there is one.  The \s-1VMS\s0 version of splitdir('[.foo]') returns '', 'foo'.
 189 .IP "expand_test_dir" 4
 190 .IX Item "expand_test_dir"
 191 Inherit the standard version but relativize the paths as the native \fIglob()\fR doesn't
 192 do that for us.
 193 .IP "_detildefy" 4
 194 .IX Item "_detildefy"
 195 The home-grown \fIglob()\fR does not currently handle tildes, so provide limited support
 196 here.  Expect only \s-1UNIX\s0 format file specifications for now.
 197 .IP "find_perl_interpreter" 4
 198 .IX Item "find_perl_interpreter"
 199 On \s-1VMS\s0, $^X returns the fully qualified absolute path including version
 200 number.  It's logically impossible to improve on it for getting the perl
 201 we're currently running, and attempting to manipulate it is usually
 202 lossy.
 203 .IP "localize_file_path" 4
 204 .IX Item "localize_file_path"
 205 Convert the file path to the local syntax
 206 .IP "localize_dir_path" 4
 207 .IX Item "localize_dir_path"
 208 Convert the directory path to the local syntax
 209 .IP "ACTION_clean" 4
 210 .IX Item "ACTION_clean"
 211 The home-grown \fIglob()\fR expands a bit too aggressively when given a bare name,
 212 so default in a zero-length extension.
 213 .SH "AUTHOR"
 214 .IX Header "AUTHOR"
 215 Michael G Schwern <schwern@pobox.com>
 216 Ken Williams <kwilliams@cpan.org>
 217 Craig A. Berry <craigberry@mac.com>
 218 .SH "SEE ALSO"
 219 .IX Header "SEE ALSO"
 220 \&\fIperl\fR\|(1), \fIModule::Build\fR\|(3), \fIExtUtils::MakeMaker\fR\|(3)