Module...m::VMS(3pm)

🌸 NAME 🌸

okay bestie, you're on the Module...m::VMS(3pm) page — the VMS-platform builder chapter of the Perl universe, and it's lowkey iconic ✨

Module::Build::Platform::VMS — Builder class for VMS platforms 💅

✨ DESCRIPTION ✨

This module inherits from Module::Build::Base and alters a few minor details of its functionality. Please see Module::Build for the general docs. Same builder energy, tiny VMS twists — we love a specialist.

💅 Overridden Methods 💅

Here's every overridden method, all accounted for, no cap 🫶

• _set_defaults — Change $self->{build_script} to 'Build.com' so @Build works. Cute little default glow-up.
• 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. Case drama? Handled.
• manpage_separator — Use '__' instead of '::'. Separator slay.
• prefixify — Prefixify taking into account VMS' filepath syntax. VMS paths get their own little lane.
• _quote_args — Command-line arguments (but not the command itself) must be quoted to ensure case preservation. Quotes where they matter, periodt.
• have_forkpipe — There is no native fork(), so some constructs depending on it are not available. Sad but true, bestie 😭
• _backticks — Override to ensure that we quote the arguments but not the command. Same energy, different backticks situation.
• find_command — the original one-liner is literally Local an executable program — keeping that exact wording, bestie 😭
• _maybe_command (override) — Follows VMS naming conventions for executable files. If the name passed in doesn't exactly match an executable file, appends .Exe (or equivalent) to check for executable image, and .Com to check for DCL procedure. If this fails, checks directories in DCL$PATH and finally Sys$System: for an executable file having the name specified, with or without the .Exe-equivalent suffix. Detective work, but make it VMS 🕵️‍♀️
• do_system — Override to ensure that we quote the arguments but not the command. Yes, again — the command gets left alone.
• oneliner — Override to ensure that we do not quote the command. No quotes on this command, thank you.
• 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. Dot rules with a tiny exception clause.
• dist_dir — Inherit the standard version but replace embedded dots with underscores because a dot is the directory delimiter on VMS. Dots become underscores, because VMS said so.
• 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'. Chop chop, delimiter.
• expand_test_dir — Inherit the standard version but relativize the paths as the native glob() doesn't do that for us. Path relativity, but make it native-glob-friendly.
• _detildefy — The home-grown glob() does not currently handle tildes, so provide limited support here. Expect only UNIX format file specifications for now. Limited tilde support — very “we're working on it” energy.
• 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. Leave $^X alone, bestie — it's already doing the most.
• localize_file_path — Convert the file path to the local syntax. Local syntax glow-up.
• localize_dir_path — Convert the directory path to the local syntax. Same localization, but for directories.
• ACTION_clean — The home-grown glob() expands a bit too aggressively when given a bare name, so default in a zero-length extension. Glob was doing too much, so we give it a little guardrail.

🫶 AUTHOR 🫶

This page was brought to you by these legends 💖

• Michael G Schwern <schwern@pobox.com>
• Ken Williams <kwilliams@cpan.org>
• Craig A. Berry <craigberry@mac.com>

🔭 SEE ALSO 🔭

Go look at perl(1), Module::Build(3), and ExtUtils::MakeMaker(3) — the related-docs squad is right there 🌈

---

okay, that's the whole page, bestie 🎀 source/version check: perl v5.42.0, date 2023-04-29, manual Module...m::VMS(3pm). bye, go make VMS behave 💅