1ExtUtils::MM_VMS(3)   User Contributed Perl Documentation  ExtUtils::MM_VMS(3)
2
3
4

NAME

6       ExtUtils::MM_VMS - methods to override UN*X behaviour in
7       ExtUtils::MakeMaker
8

SYNOPSIS

10         Do not use this directly.
11         Instead, use ExtUtils::MM and it will figure out which MM_*
12         class to use for you.
13

DESCRIPTION

15       See ExtUtils::MM_Unix for a documentation of the methods provided
16       there. This package overrides the implementation of these methods, not
17       the semantics.
18
19   Methods always loaded
20       wraplist
21           Converts a list into a string wrapped at approximately 80 columns.
22
23   Methods
24       Those methods which override default MM_Unix methods are marked
25       "(override)", while methods unique to MM_VMS are marked "(specific)".
26       For overridden methods, documentation is limited to an explanation of
27       why this method overrides the MM_Unix method; see the ExtUtils::MM_Unix
28       documentation for more details.
29
30       guess_name (override)
31           Try to determine name of extension being built.  We begin with the
32           name of the current directory.  Since VMS filenames are case-
33           insensitive, however, we look for a .pm file whose name matches
34           that of the current directory (presumably the 'main' .pm file for
35           this extension), and try to find a "package" statement from which
36           to obtain the Mixed::Case package name.
37
38       find_perl (override)
39           Use VMS file specification syntax and CLI commands to find and
40           invoke Perl images.
41
42       _fixin_replace_shebang (override)
43           Helper routine for MM->fixin(), overridden because there's no such
44           thing as an actual shebang line that will be interpreted by the
45           shell, so we just prepend $Config{startperl} and preserve the
46           shebang line argument for any switches it may contain.
47
48       maybe_command (override)
49           Follows VMS naming conventions for executable files.  If the name
50           passed in doesn't exactly match an executable file, appends .Exe
51           (or equivalent) to check for executable image, and .Com to check
52           for DCL procedure.  If this fails, checks directories in DCL$PATH
53           and finally Sys$System: for an executable file having the name
54           specified, with or without the .Exe-equivalent suffix.
55
56       pasthru (override)
57           VMS has $(MMSQUALIFIERS) which is a listing of all the original
58           command line options.  This is used in every invocation of make in
59           the VMS Makefile so PASTHRU should not be necessary.  Using PASTHRU
60           tends to blow commands past the 256 character limit.
61
62       pm_to_blib (override)
63           VMS wants a dot in every file so we can't have one called
64           'pm_to_blib', it becomes 'pm_to_blib.' and MMS/K isn't smart enough
65           to know that when you have a target called 'pm_to_blib' it should
66           look for 'pm_to_blib.'.
67
68           So in VMS its pm_to_blib.ts.
69
70       perl_script (override)
71           If name passed in doesn't specify a readable file, appends .com or
72           .pl and tries again, since it's customary to have file types on all
73           files under VMS.
74
75       replace_manpage_separator
76           Use as separator a character which is legal in a VMS-syntax file
77           name.
78
79       init_DEST
80           (override) Because of the difficulty concatenating VMS filepaths we
81           must pre-expand the DEST* variables.
82
83       init_DIRFILESEP
84           No separator between a directory path and a filename on VMS.
85
86       init_main (override)
87       init_tools (override)
88           Provide VMS-specific forms of various utility commands.
89
90           Sets DEV_NULL to nothing because I don't know how to do it on VMS.
91
92           Changes EQUALIZE_TIMESTAMP to set revision date of target file to
93           one second later than source file, since MMK interprets precisely
94           equal revision dates for a source and target file as a sign that
95           the target needs to be updated.
96
97       init_platform (override)
98           Add PERL_VMS, MM_VMS_REVISION and MM_VMS_VERSION.
99
100           MM_VMS_REVISION is for backwards compatibility before MM_VMS had a
101           $VERSION.
102
103       platform_constants
104       init_VERSION (override)
105           Override the *DEFINE_VERSION macros with VMS semantics.  Translate
106           the MAKEMAKER filepath to VMS style.
107
108       constants (override)
109           Fixes up numerous file and directory macros to insure VMS syntax
110           regardless of input syntax.  Also makes lists of files comma-
111           separated.
112
113       special_targets
114           Clear the default .SUFFIXES and put in our own list.
115
116       cflags (override)
117           Bypass shell script and produce qualifiers for CC directly (but
118           warn user if a shell script for this extension exists).  Fold
119           multiple /Defines into one, since some C compilers pay attention to
120           only one instance of this qualifier on the command line.
121
122       const_cccmd (override)
123           Adds directives to point C preprocessor to the right place when
124           handling #include <sys/foo.h> directives.  Also constructs CC
125           command line a bit differently than MM_Unix method.
126
127       tools_other (override)
128           Throw in some dubious extra macros for Makefile args.
129
130           Also keep around the old $(SAY) macro in case somebody's using it.
131
132       init_dist (override)
133           VMSish defaults for some values.
134
135             macro         description                     default
136
137             ZIPFLAGS      flags to pass to ZIP            -Vu
138
139             COMPRESS      compression command to          gzip
140                           use for tarfiles
141             SUFFIX        suffix to put on                -gz
142                           compressed files
143
144             SHAR          shar command to use             vms_share
145
146             DIST_DEFAULT  default target to use to        tardist
147                           create a distribution
148
149             DISTVNAME     Use VERSION_SYM instead of      $(DISTNAME)-$(VERSION_SYM)
150                           VERSION for the name
151
152       c_o (override)
153           Use VMS syntax on command line.  In particular, $(DEFINE) and
154           $(PERL_INC) have been pulled into $(CCCMD).  Also use MM[SK]
155           macros.
156
157       xs_c (override)
158           Use MM[SK] macros.
159
160       xs_o (override)
161           Use MM[SK] macros, and VMS command line for C compiler.
162
163       dlsyms (override)
164           Create VMS linker options files specifying universal symbols for
165           this extension's shareable image, and listing other shareable
166           images or libraries to which it should be linked.
167
168       dynamic_lib (override)
169           Use VMS Link command.
170
171       static_lib (override)
172           Use VMS commands to manipulate object library.
173
174       extra_clean_files
175           Clean up some OS specific files.  Plus the temp file used to
176           shorten a lot of commands.  And the name mangler database.
177
178       zipfile_target
179       tarfile_target
180       shdist_target
181           Syntax for invoking shar, tar and zip differs from that for Unix.
182
183       install (override)
184           Work around DCL's 255 character limit several times,and use VMS-
185           style command line quoting in a few cases.
186
187       perldepend (override)
188           Use VMS-style syntax for files; it's cheaper to just do it directly
189           here than to have the MM_Unix method call "catfile" repeatedly.
190           Also, if we have to rebuild Config.pm, use MM[SK] to do it.
191
192       makeaperl (override)
193           Undertake to build a new set of Perl images using VMS commands.
194           Since VMS does dynamic loading, it's not necessary to statically
195           link each extension into the Perl image, so this isn't the normal
196           build path.  Consequently, it hasn't really been tested, and may
197           well be incomplete.
198
199       maketext_filter (override)
200           Insure that colons marking targets are preceded by space, in order
201           to distinguish the target delimiter from a colon appearing as part
202           of a filespec.
203
204       prefixify (override)
205           prefixifying on VMS is simple.  Each should simply be:
206
207               perl_root:[some.dir]
208
209           which can just be converted to:
210
211               volume:[your.prefix.some.dir]
212
213           otherwise you get the default layout.
214
215           In effect, your search prefix is ignored and $Config{vms_prefix} is
216           used instead.
217
218       cd
219       oneliner
220       echo
221           perl trips up on "<foo>" thinking it's an input redirect.  So we
222           use the native Write command instead.  Besides, its faster.
223
224       quote_literal
225       escape_dollarsigns
226           Quote, don't escape.
227
228       escape_all_dollarsigns
229           Quote, don't escape.
230
231       escape_newlines
232       max_exec_len
233           256 characters.
234
235       init_linker
236       catdir (override)
237       catfile (override)
238           Eliminate the macros in the output to the MMS/MMK file.
239
240           (File::Spec::VMS used to do this for us, but it's being removed)
241
242       eliminate_macros
243           Expands MM[KS]/Make macros in a text string, using the contents of
244           identically named elements of %$self, and returns the result as a
245           file specification in Unix syntax.
246
247           NOTE:  This is the canonical version of the method.  The version in
248           File::Spec::VMS is deprecated.
249
250       fixpath
251              my $path = $mm->fixpath($path);
252              my $path = $mm->fixpath($path, $is_dir);
253
254           Catchall routine to clean up problem MM[SK]/Make macros.  Expands
255           macros in any directory specification, in order to avoid
256           juxtaposing two VMS-syntax directories when MM[SK] is run.  Also
257           expands expressions which are all macro, so that we can tell how
258           long the expansion is, and avoid overrunning DCL's command buffer
259           when MM[KS] is running.
260
261           fixpath() checks to see whether the result matches the name of a
262           directory in the current default directory and returns a directory
263           or file specification accordingly.  $is_dir can be set to true to
264           force fixpath() to consider the path to be a directory or false to
265           force it to be a file.
266
267           NOTE:  This is the canonical version of the method.  The version in
268           File::Spec::VMS is deprecated.
269
270       os_flavor
271           VMS is VMS.
272

AUTHOR

274       Original author Charles Bailey bailey@newman.upenn.edu
275
276       Maintained by Michael G Schwern schwern@pobox.com
277
278       See ExtUtils::MakeMaker for patching and contact information.
279
280
281
282perl v5.16.3                      2013-06-14               ExtUtils::MM_VMS(3)
Impressum