.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "Module::Build::Platform::VMS 3pm" .TH Module::Build::Platform::VMS 3pm 2023-07-25 "perl v5.38.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NAME Module::Build::Platform::VMS \- Builder class for VMS platforms .SH DESCRIPTION .IX Header "DESCRIPTION" This module inherits from \f(CW\*(C`Module::Build::Base\*(C'\fR and alters a few minor details of its functionality. Please see Module::Build for the general docs. .SS "Overridden Methods" .IX Subsection "Overridden Methods" .IP _set_defaults 4 .IX Item "_set_defaults" Change \f(CW$self\fR\->{build_script} to 'Build.com' so \f(CW@Build\fR works. .IP cull_args 4 .IX Item "cull_args" \&'@Build foo' on VMS will not preserve the case of 'foo'. Rather than forcing people to write '@Build "foo"' we'll dispatch case-insensitively. .IP manpage_separator 4 .IX Item "manpage_separator" Use '_\|_' instead of '::'. .IP prefixify 4 .IX Item "prefixify" Prefixify taking into account VMS' filepath syntax. .IP _quote_args 4 .IX Item "_quote_args" Command-line arguments (but not the command itself) must be quoted to ensure case preservation. .IP have_forkpipe 4 .IX Item "have_forkpipe" There is no native \fBfork()\fR, so some constructs depending on it are not available. .IP _backticks 4 .IX Item "_backticks" Override to ensure that we quote the arguments but not the command. .IP find_command 4 .IX Item "find_command" Local an executable program .IP "_maybe_command (override)" 4 .IX Item "_maybe_command (override)" Follows VMS naming conventions for executable files. If the name passed in doesn't exactly match an executable file, appends \fI.Exe\fR (or equivalent) to check for executable image, and \fI.Com\fR to check for DCL procedure. If this fails, checks directories in DCL$PATH and finally \fISys$System:\fR for an executable file having the name specified, with or without the \fI.Exe\fR\-equivalent suffix. .IP do_system 4 .IX Item "do_system" Override to ensure that we quote the arguments but not the command. .IP oneliner 4 .IX Item "oneliner" Override to ensure that we do not quote the command. .IP rscan_dir 4 .IX Item "rscan_dir" Inherit the standard version but remove dots at end of name. If the extended character set is in effect, do not remove dots from filenames with Unix path delimiters. .IP dist_dir 4 .IX Item "dist_dir" Inherit the standard version but replace embedded dots with underscores because a dot is the directory delimiter on VMS. .IP man3page_name 4 .IX Item "man3page_name" Inherit the standard version but chop the extra manpage delimiter off the front if there is one. The VMS version of splitdir('[.foo]') returns '', 'foo'. .IP expand_test_dir 4 .IX Item "expand_test_dir" Inherit the standard version but relativize the paths as the native \fBglob()\fR doesn't do that for us. .IP _detildefy 4 .IX Item "_detildefy" The home-grown \fBglob()\fR does not currently handle tildes, so provide limited support here. Expect only UNIX format file specifications for now. .IP find_perl_interpreter 4 .IX Item "find_perl_interpreter" On VMS, $^X returns the fully qualified absolute path including version number. It's logically impossible to improve on it for getting the perl we're currently running, and attempting to manipulate it is usually lossy. .IP localize_file_path 4 .IX Item "localize_file_path" Convert the file path to the local syntax .IP localize_dir_path 4 .IX Item "localize_dir_path" Convert the directory path to the local syntax .IP ACTION_clean 4 .IX Item "ACTION_clean" The home-grown \fBglob()\fR expands a bit too aggressively when given a bare name, so default in a zero-length extension. .SH AUTHOR .IX Header "AUTHOR" Michael G Schwern Ken Williams Craig A. Berry .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBperl\fR\|(1), \fBModule::Build\fR\|(3), \fBExtUtils::MakeMaker\fR\|(3)