Debian Codegraph @

upstream/opensuse-tumbleweed/man3/ExtUtils::MM_Unix.3pm

raw
1 .\" -*- mode: troff; coding: utf-8 -*-
2 .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
3 .\"
4 .\" Standard preamble:
5 .\" ========================================================================
6 .de Sp \" Vertical space (when we can't use .PP)
7 .if t .sp .5v
8 .if n .sp
9 ..
10 .de Vb \" Begin verbatim text
11 .ft CW
12 .nf
13 .ne \\$1
14 ..
15 .de Ve \" End verbatim text
16 .ft R
17 .fi
18 ..
19 .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
20 .ie n \{\
21 . ds C` ""
22 . ds C' ""
23 'br\}
24 .el\{\
25 . ds C`
26 . ds C'
27 'br\}
28 .\"
29 .\" Escape single quotes in literal strings from groff's Unicode transform.
30 .ie \n(.g .ds Aq \(aq
31 .el .ds Aq '
32 .\"
33 .\" If the F register is >0, we'll generate index entries on stderr for
34 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
35 .\" entries marked with X<> in POD. Of course, you'll have to process the
36 .\" output yourself in some meaningful fashion.
37 .\"
38 .\" Avoid warning from groff about undefined register 'F'.
39 .de IX
40 ..
41 .nr rF 0
42 .if \n(.g .if rF .nr rF 1
43 .if (\n(rF:(\n(.g==0)) \{\
44 . if \nF \{\
45 . de IX
46 . tm Index:\\$1\t\\n%\t"\\$2"
47 ..
48 . if !\nF==2 \{\
49 . nr % 0
50 . nr F 2
51 . \}
52 . \}
53 .\}
54 .rr rF
55 .\"
56 .\" Required to disable full justification in groff 1.23.0.
57 .if n .ds AD l
58 .\" ========================================================================
59 .\"
60 .IX Title "ExtUtils::MM_Unix 3pm"
61 .TH ExtUtils::MM_Unix 3pm 2026-03-09 "perl v5.42.1" "Perl Programmers Reference Guide"
62 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
63 .\" way too many mistakes in technical documents.
64 .if n .ad l
65 .nh
66 .SH NAME
67 ExtUtils::MM_Unix \- methods used by ExtUtils::MakeMaker
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 .Vb 1
71 \& require ExtUtils::MM_Unix;
72 .Ve
73 .SH DESCRIPTION
74 .IX Header "DESCRIPTION"
75 The methods provided by this package are designed to be used in
76 conjunction with ExtUtils::MakeMaker. When MakeMaker writes a
77 Makefile, it creates one or more objects that inherit their methods
78 from a package MM. MM itself doesn\*(Aqt provide any methods, but
79 it ISA ExtUtils::MM_Unix class. The inheritance tree of MM lets operating
80 specific packages take the responsibility for all the methods provided
81 by MM_Unix. We are trying to reduce the number of the necessary
82 overrides by defining rather primitive operations within
83 ExtUtils::MM_Unix.
84 .PP
85 If you are going to write a platform specific MM package, please try
86 to limit the necessary overrides to primitive methods, and if it is not
87 possible to do so, let\*(Aqs work out how to achieve that gain.
88 .PP
89 If you are overriding any of these methods in your Makefile.PL (in the
90 MY class), please report that to the makemaker mailing list. We are
91 trying to minimize the necessary method overrides and switch to data
92 driven Makefile.PLs wherever possible. In the long run less methods
93 will be overridable via the MY class.
94 .SH METHODS
95 .IX Header "METHODS"
96 The following description of methods is still under
97 development. Please refer to the code for not suitably documented
98 sections and complain loudly to the [email protected] mailing list.
99 Better yet, provide a patch.
100 .PP
101 Not all of the methods below are overridable in a
102 Makefile.PL. Overridable methods are marked as (o). All methods are
103 overridable by a platform specific MM_*.pm file.
104 .PP
105 Cross\-platform methods are being moved into MM_Any.
106 If you can\*(Aqt find something that used to be in here, look in MM_Any.
107 .SS Methods
108 .IX Subsection "Methods"
109 .IP os_flavor 4
110 .IX Item "os_flavor"
111 Simply says that we\*(Aqre Unix.
112 .IP "c_o (o)" 4
113 .IX Item "c_o (o)"
114 Defines the suffix rules to compile different flavors of C files to
115 object files.
116 .IP xs_obj_opt 4
117 .IX Item "xs_obj_opt"
118 Takes the object file as an argument, and returns the portion of compile
119 command\-line that will output to the specified object file.
120 .IP dbgoutflag 4
121 .IX Item "dbgoutflag"
122 Returns a CC flag that tells the CC to emit a separate debugging symbol file
123 when compiling an object file.
124 .IP "cflags (o)" 4
125 .IX Item "cflags (o)"
126 Does very much the same as the cflags script in the perl
127 distribution. It doesn\*(Aqt return the whole compiler command line, but
128 initializes all of its parts. The const_cccmd method then actually
129 returns the definition of the CCCMD macro which uses these parts.
130 .IP "const_cccmd (o)" 4
131 .IX Item "const_cccmd (o)"
132 Returns the full compiler call for C programs and stores the
133 definition in CONST_CCCMD.
134 .IP "const_config (o)" 4
135 .IX Item "const_config (o)"
136 Sets SHELL if needed, then defines a couple of constants in the Makefile
137 that are imported from \f(CW%Config\fR.
138 .IP "const_loadlibs (o)" 4
139 .IX Item "const_loadlibs (o)"
140 Defines EXTRALIBS, LDLOADLIBS, BSLOADLIBS, LD_RUN_PATH. See
141 ExtUtils::Liblist for details.
142 .IP "constants (o)" 4
143 .IX Item "constants (o)"
144 .Vb 1
145 \& my $make_frag = $mm\->constants;
146 .Ve
147 .Sp
148 Prints out macros for lots of constants.
149 .IP "dep_constants (o)" 4
150 .IX Item "dep_constants (o)"
151 .Vb 1
152 \& my $make_frag = $mm\->dep_constants;
153 .Ve
154 .Sp
155 Prints out macros for dependency constants.
156 .IP "depend (o)" 4
157 .IX Item "depend (o)"
158 Same as macro for the depend attribute.
159 .IP init_DEST 4
160 .IX Item "init_DEST"
161 .Vb 1
162 \& $mm\->init_DEST
163 .Ve
164 .Sp
165 Defines the DESTDIR and DEST* variables paralleling the INSTALL*.
166 .IP init_dist 4
167 .IX Item "init_dist"
168 .Vb 1
169 \& $mm\->init_dist;
170 .Ve
171 .Sp
172 Defines a lot of macros for distribution support.
173 .Sp
174 .Vb 1
175 \& macro description default
176 \&
177 \& TAR tar command to use tar
178 \& TARFLAGS flags to pass to TAR cvf
179 \&
180 \& ZIP zip command to use zip
181 \& ZIPFLAGS flags to pass to ZIP \-r
182 \&
183 \& COMPRESS compression command to gzip \-\-best
184 \& use for tarfiles
185 \& SUFFIX suffix to put on .gz
186 \& compressed files
187 \&
188 \& SHAR shar command to use shar
189 \&
190 \& PREOP extra commands to run before
191 \& making the archive
192 \& POSTOP extra commands to run after
193 \& making the archive
194 \&
195 \& TO_UNIX a command to convert linefeeds
196 \& to Unix style in your archive
197 \&
198 \& CI command to checkin your ci \-u
199 \& sources to version control
200 \& RCS_LABEL command to label your sources rcs \-Nv$(VERSION_SYM): \-q
201 \& just after CI is run
202 \&
203 \& DIST_CP $how argument to manicopy() best
204 \& when the distdir is created
205 \&
206 \& DIST_DEFAULT default target to use to tardist
207 \& create a distribution
208 \&
209 \& DISTVNAME name of the resulting archive $(DISTNAME)\-$(VERSION)
210 \& (minus suffixes)
211 .Ve
212 .IP "dist (o)" 4
213 .IX Item "dist (o)"
214 .Vb 1
215 \& my $dist_macros = $mm\->dist(%overrides);
216 .Ve
217 .Sp
218 Generates a make fragment defining all the macros initialized in
219 init_dist.
220 .Sp
221 \&\f(CW%overrides\fR can be used to override any of the above.
222 .IP "dist_basics (o)" 4
223 .IX Item "dist_basics (o)"
224 Defines the targets distclean, distcheck, skipcheck, manifest, veryclean.
225 .IP "dist_ci (o)" 4
226 .IX Item "dist_ci (o)"
227 Defines a check in target for RCS.
228 .IP "dist_core (o)" 4
229 .IX Item "dist_core (o)"
230 .Vb 1
231 \& my $dist_make_fragment = $MM\->dist_core;
232 .Ve
233 .Sp
234 Puts the targets necessary for \*(Aqmake dist\*(Aq together into one make
235 fragment.
236 .IP \fBdist_target\fR 4
237 .IX Item "dist_target"
238 .Vb 1
239 \& my $make_frag = $MM\->dist_target;
240 .Ve
241 .Sp
242 Returns the \*(Aqdist\*(Aq target to make an archive for distribution. This
243 target simply checks to make sure the Makefile is up\-to\-date and
244 depends on $(DIST_DEFAULT).
245 .IP \fBtardist_target\fR 4
246 .IX Item "tardist_target"
247 .Vb 1
248 \& my $make_frag = $MM\->tardist_target;
249 .Ve
250 .Sp
251 Returns the \*(Aqtardist\*(Aq target which is simply so \*(Aqmake tardist\*(Aq works.
252 The real work is done by the dynamically named \fBtardistfile_target()\fR
253 method, tardist should have that as a dependency.
254 .IP \fBzipdist_target\fR 4
255 .IX Item "zipdist_target"
256 .Vb 1
257 \& my $make_frag = $MM\->zipdist_target;
258 .Ve
259 .Sp
260 Returns the \*(Aqzipdist\*(Aq target which is simply so \*(Aqmake zipdist\*(Aq works.
261 The real work is done by the dynamically named \fBzipdistfile_target()\fR
262 method, zipdist should have that as a dependency.
263 .IP \fBtarfile_target\fR 4
264 .IX Item "tarfile_target"
265 .Vb 1
266 \& my $make_frag = $MM\->tarfile_target;
267 .Ve
268 .Sp
269 The name of this target is the name of the tarball generated by
270 tardist. This target does the actual work of turning the distdir into
271 a tarball.
272 .IP zipfile_target 4
273 .IX Item "zipfile_target"
274 .Vb 1
275 \& my $make_frag = $MM\->zipfile_target;
276 .Ve
277 .Sp
278 The name of this target is the name of the zip file generated by
279 zipdist. This target does the actual work of turning the distdir into
280 a zip file.
281 .IP uutardist_target 4
282 .IX Item "uutardist_target"
283 .Vb 1
284 \& my $make_frag = $MM\->uutardist_target;
285 .Ve
286 .Sp
287 Converts the tarfile into a uuencoded file
288 .IP shdist_target 4
289 .IX Item "shdist_target"
290 .Vb 1
291 \& my $make_frag = $MM\->shdist_target;
292 .Ve
293 .Sp
294 Converts the distdir into a shell archive.
295 .IP "dlsyms (o)" 4
296 .IX Item "dlsyms (o)"
297 Used by some OS\*(Aq to define DL_FUNCS and DL_VARS and write the *.exp files.
298 .Sp
299 Normally just returns an empty string.
300 .IP "dynamic_bs (o)" 4
301 .IX Item "dynamic_bs (o)"
302 Defines targets for bootstrap files.
303 .IP "dynamic_lib (o)" 4
304 .IX Item "dynamic_lib (o)"
305 Defines how to produce the *.so (or equivalent) files.
306 .IP xs_dynamic_lib_macros 4
307 .IX Item "xs_dynamic_lib_macros"
308 Defines the macros for the \f(CW\*(C`dynamic_lib\*(C'\fR section.
309 .IP xs_make_dynamic_lib 4
310 .IX Item "xs_make_dynamic_lib"
311 Defines the recipes for the \f(CW\*(C`dynamic_lib\*(C'\fR section.
312 .IP exescan 4
313 .IX Item "exescan"
314 Deprecated method. Use libscan instead.
315 .IP extliblist 4
316 .IX Item "extliblist"
317 Called by init_others, and calls ext ExtUtils::Liblist. See
318 ExtUtils::Liblist for details.
319 .IP find_perl 4
320 .IX Item "find_perl"
321 Finds the executables PERL and FULLPERL
322 .IP fixin 4
323 .IX Item "fixin"
324 .Vb 1
325 \& $mm\->fixin(@files);
326 .Ve
327 .Sp
328 Inserts the sharpbang or equivalent magic number to a set of \f(CW@files\fR.
329 .IP "force (o)" 4
330 .IX Item "force (o)"
331 Writes an empty FORCE: target.
332 .IP guess_name 4
333 .IX Item "guess_name"
334 Guess the name of this package by examining the working directory\*(Aqs
335 name. MakeMaker calls this only if the developer has not supplied a
336 NAME attribute.
337 .IP has_link_code 4
338 .IX Item "has_link_code"
339 Returns true if C, XS, MYEXTLIB or similar objects exist within this
340 object that need a compiler. Does not descend into subdirectories as
341 \&\fBneeds_linking()\fR does.
342 .IP init_dirscan 4
343 .IX Item "init_dirscan"
344 Scans the directory structure and initializes DIR, XS, XS_FILES,
345 C, C_FILES, O_FILES, H, H_FILES, PL_FILES, EXE_FILES.
346 .Sp
347 Called by init_main.
348 .IP init_MANPODS 4
349 .IX Item "init_MANPODS"
350 Determines if man pages should be generated and initializes MAN1PODS
351 and MAN3PODS as appropriate.
352 .IP init_MAN1PODS 4
353 .IX Item "init_MAN1PODS"
354 Initializes MAN1PODS from the list of EXE_FILES.
355 .IP init_MAN3PODS 4
356 .IX Item "init_MAN3PODS"
357 Initializes MAN3PODS from the list of PM files.
358 .IP init_PM 4
359 .IX Item "init_PM"
360 Initializes PMLIBDIRS and PM from PMLIBDIRS.
361 .IP init_DIRFILESEP 4
362 .IX Item "init_DIRFILESEP"
363 Using / for Unix. Called by init_main.
364 .IP init_main 4
365 .IX Item "init_main"
366 Initializes AR, AR_STATIC_ARGS, BASEEXT, CONFIG, DISTNAME, DLBASE,
367 EXE_EXT, FULLEXT, FULLPERL, FULLPERLRUN, FULLPERLRUNINST, INST_*,
368 INSTALL*, INSTALLDIRS, LIB_EXT, LIBPERL_A, MAP_TARGET, NAME,
369 OBJ_EXT, PARENT_NAME, PERL, PERL_ARCHLIB, PERL_INC, PERL_LIB,
370 PERL_SRC, PERLRUN, PERLRUNINST, PREFIX, VERSION,
371 VERSION_SYM, XS_VERSION.
372 .IP init_tools 4
373 .IX Item "init_tools"
374 Initializes tools to use their common (and faster) Unix commands.
375 .IP init_linker 4
376 .IX Item "init_linker"
377 Unix has no need of special linker flags.
378 .IP init_PERL 4
379 .IX Item "init_PERL"
380 .Vb 1
381 \& $mm\->init_PERL;
382 .Ve
383 .Sp
384 Called by init_main. Sets up ABSPERL, PERL, FULLPERL and all the
385 *PERLRUN* permutations.
386 .Sp
387 .Vb 2
388 \& PERL is allowed to be miniperl
389 \& FULLPERL must be a complete perl
390 \&
391 \& ABSPERL is PERL converted to an absolute path
392 \&
393 \& *PERLRUN contains everything necessary to run perl, find it\*(Aqs
394 \& libraries, etc...
395 \&
396 \& *PERLRUNINST is *PERLRUN + everything necessary to find the
397 \& modules being built.
398 .Ve
399 .IP init_platform 4
400 .IX Item "init_platform"
401 .PD 0
402 .IP platform_constants 4
403 .IX Item "platform_constants"
404 .PD
405 Add MM_Unix_VERSION.
406 .IP init_PERM 4
407 .IX Item "init_PERM"
408 .Vb 1
409 \& $mm\->init_PERM
410 .Ve
411 .Sp
412 Called by init_main. Initializes PERL_*
413 .IP init_xs 4
414 .IX Item "init_xs"
415 .Vb 1
416 \& $mm\->init_xs
417 .Ve
418 .Sp
419 Sets up macros having to do with XS code. Currently just INST_STATIC,
420 INST_DYNAMIC and INST_BOOT.
421 .IP "install (o)" 4
422 .IX Item "install (o)"
423 Defines the install target.
424 .IP "installbin (o)" 4
425 .IX Item "installbin (o)"
426 Defines targets to make and to install EXE_FILES.
427 .IP "linkext (o)" 4
428 .IX Item "linkext (o)"
429 Defines the linkext target which in turn defines the LINKTYPE.
430 .IP lsdir 4
431 .IX Item "lsdir"
432 Takes as arguments a directory name and a regular expression. Returns
433 all entries in the directory that match the regular expression.
434 .IP "macro (o)" 4
435 .IX Item "macro (o)"
436 Simple subroutine to insert the macros defined by the macro attribute
437 into the Makefile.
438 .IP "makeaperl (o)" 4
439 .IX Item "makeaperl (o)"
440 Called by staticmake. Defines how to write the Makefile to produce a
441 static new perl.
442 .Sp
443 By default the Makefile produced includes all the static extensions in
444 the perl library. (Purified versions of library files, e.g.,
445 DynaLoader_pure_p1_c0_032.a are automatically ignored to avoid link errors.)
446 .IP "xs_static_lib_is_xs (o)" 4
447 .IX Item "xs_static_lib_is_xs (o)"
448 Called by a utility method of makeaperl. Checks whether a given file
449 is an XS library by seeing whether it defines any symbols starting
450 with \f(CW\*(C`boot_\*(C'\fR (with an optional leading underscore \- needed on MacOS).
451 .IP "makefile (o)" 4
452 .IX Item "makefile (o)"
453 Defines how to rewrite the Makefile.
454 .IP maybe_command 4
455 .IX Item "maybe_command"
456 Returns true, if the argument is likely to be a command.
457 .IP "needs_linking (o)" 4
458 .IX Item "needs_linking (o)"
459 Does this module need linking? Looks into subdirectory objects (see
460 also \fBhas_link_code()\fR)
461 .IP parse_abstract 4
462 .IX Item "parse_abstract"
463 parse a file and return what you think is the ABSTRACT
464 .IP parse_version 4
465 .IX Item "parse_version"
466 .Vb 1
467 \& my $version = MM\->parse_version($file);
468 .Ve
469 .Sp
470 Parse a \f(CW$file\fR and return what \f(CW$VERSION\fR is set to by the first assignment.
471 It will return the string "undef" if it can\*(Aqt figure out what \f(CW$VERSION\fR
472 is. \f(CW$VERSION\fR should be for all to see, so \f(CW\*(C`our $VERSION\*(C'\fR or plain \f(CW$VERSION\fR
473 are okay, but \f(CW\*(C`my $VERSION\*(C'\fR is not.
474 .Sp
475 \&\f(CW\*(C`package Foo VERSION\*(C'\fR is also checked for. The first version
476 declaration found is used, but this may change as it differs from how
477 Perl does it.
478 .Sp
479 \&\fBparse_version()\fR will try to \f(CW\*(C`use version\*(C'\fR before checking for
480 \&\f(CW$VERSION\fR so the following will work.
481 .Sp
482 .Vb 1
483 \& $VERSION = qv(1.2.3);
484 .Ve
485 .IP "pasthru (o)" 4
486 .IX Item "pasthru (o)"
487 Defines the string that is passed to recursive make calls in
488 subdirectories. The variables like \f(CW\*(C`PASTHRU_DEFINE\*(C'\fR are used in each
489 level, and passed downwards on the command\-line with e.g. the value of
490 that level\*(Aqs DEFINE. Example:
491 .Sp
492 .Vb 6
493 \& # Level 0 has DEFINE = \-Dfunky
494 \& # This code will define level 0\*(Aqs PASTHRU=PASTHRU_DEFINE="$(DEFINE)
495 \& # $(PASTHRU_DEFINE)"
496 \& # Level 0\*(Aqs $(CCCMD) will include macros $(DEFINE) and $(PASTHRU_DEFINE)
497 \& # So will level 1\*(Aqs, so when level 1 compiles, it will get right values
498 \& # And so ad infinitum
499 .Ve
500 .IP perl_script 4
501 .IX Item "perl_script"
502 Takes one argument, a file name, and returns the file name, if the
503 argument is likely to be a perl script. On MM_Unix this is true for
504 any ordinary, readable file.
505 .IP "perldepend (o)" 4
506 .IX Item "perldepend (o)"
507 Defines the dependency from all *.h files that come with the perl
508 distribution.
509 .IP pm_to_blib 4
510 .IX Item "pm_to_blib"
511 Defines target that copies all files in the hash PM to their
512 destination and autosplits them. See "DESCRIPTION" in ExtUtils::Install
513 .IP ppd 4
514 .IX Item "ppd"
515 Defines target that creates a PPD (Perl Package Description) file
516 for a binary distribution.
517 .IP prefixify 4
518 .IX Item "prefixify"
519 .Vb 1
520 \& $MM\->prefixify($var, $prefix, $new_prefix, $default);
521 .Ve
522 .Sp
523 Using either \f(CW$MM\fR\->{uc \f(CW$var\fR} || \f(CW$Config\fR{lc \f(CW$var\fR}, it will attempt to
524 replace it\*(Aqs \f(CW$prefix\fR with a \f(CW$new_prefix\fR.
525 .Sp
526 Should the \f(CW$prefix\fR fail to match \fIAND\fR a PREFIX was given as an
527 argument to \fBWriteMakefile()\fR it will set it to the \f(CW$new_prefix\fR +
528 \&\f(CW$default\fR. This is for systems whose file layouts don\*(Aqt neatly fit into
529 our ideas of prefixes.
530 .Sp
531 This is for heuristics which attempt to create directory structures
532 that mirror those of the installed perl.
533 .Sp
534 For example:
535 .Sp
536 .Vb 1
537 \& $MM\->prefixify(\*(Aqinstallman1dir\*(Aq, \*(Aq/usr\*(Aq, \*(Aq/home/foo\*(Aq, \*(Aqman/man1\*(Aq);
538 .Ve
539 .Sp
540 this will attempt to remove \*(Aq/usr\*(Aq from the front of the
541 \&\f(CW$MM\fR\->{INSTALLMAN1DIR} path (initializing it to \f(CW$Config\fR{installman1dir}
542 if necessary) and replace it with \*(Aq/home/foo\*(Aq. If this fails it will
543 simply use \*(Aq/home/foo/man/man1\*(Aq.
544 .IP "processPL (o)" 4
545 .IX Item "processPL (o)"
546 Defines targets to run *.PL files.
547 .IP specify_shell 4
548 .IX Item "specify_shell"
549 Specify SHELL if needed \- not done on Unix.
550 .IP quote_paren 4
551 .IX Item "quote_paren"
552 Backslashes parentheses \f(CW\*(C`()\*(C'\fR in command line arguments.
553 Doesn\*(Aqt handle recursive Makefile \f(CW\*(C`$(...)\*(C'\fR constructs,
554 but handles simple ones.
555 .IP replace_manpage_separator 4
556 .IX Item "replace_manpage_separator"
557 .Vb 1
558 \& my $man_name = $MM\->replace_manpage_separator($file_path);
559 .Ve
560 .Sp
561 Takes the name of a package, which may be a nested package, in the
562 form \*(AqFoo/Bar.pm\*(Aq and replaces the slash with \f(CW\*(C`::\*(C'\fR or something else
563 safe for a man page file name. Returns the replacement.
564 .IP cd 4
565 .IX Item "cd"
566 On BSD make, will add a countervailing \f(CW\*(C`cd ..\*(C'\fR on each command since
567 parallel builds run all the commands in a recipe in the same shell.
568 .IP oneliner 4
569 .IX Item "oneliner"
570 .PD 0
571 .IP quote_literal 4
572 .IX Item "quote_literal"
573 .PD
574 Quotes macro literal value suitable for being used on a command line so
575 that when expanded by make, will be received by command as given to
576 this method:
577 .Sp
578 .Vb 6
579 \& my $quoted = $mm\->quote_literal(q{it isn\*(Aqt});
580 \& # returns:
581 \& # \*(Aqit isn\*(Aq\e\*(Aq\*(Aqt\*(Aq
582 \& print MAKEFILE "target:\en\etecho $quoted\en";
583 \& # when run "make target", will output:
584 \& # it isn\*(Aqt
585 .Ve
586 .IP escape_newlines 4
587 .IX Item "escape_newlines"
588 .PD 0
589 .IP max_exec_len 4
590 .IX Item "max_exec_len"
591 .PD
592 Using POSIX::ARG_MAX. Otherwise falling back to 4096.
593 .IP "static (o)" 4
594 .IX Item "static (o)"
595 Defines the static target.
596 .IP xs_make_static_lib 4
597 .IX Item "xs_make_static_lib"
598 Defines the recipes for the \f(CW\*(C`static_lib\*(C'\fR section.
599 .IP static_lib_closures 4
600 .IX Item "static_lib_closures"
601 Records \f(CW\*(C`$(EXTRALIBS)\*(C'\fR in \fIextralibs.ld\fR and \fI$(PERL_SRC)/ext.libs\fR.
602 .IP static_lib_fixtures 4
603 .IX Item "static_lib_fixtures"
604 Handles copying \f(CW\*(C`$(MYEXTLIB)\*(C'\fR as starter for final static library that
605 then gets added to.
606 .IP static_lib_pure_cmd 4
607 .IX Item "static_lib_pure_cmd"
608 Defines how to run the archive utility.
609 .IP "staticmake (o)" 4
610 .IX Item "staticmake (o)"
611 Calls makeaperl.
612 .IP "subdir_x (o)" 4
613 .IX Item "subdir_x (o)"
614 Helper subroutine for subdirs
615 .IP "subdirs (o)" 4
616 .IX Item "subdirs (o)"
617 Defines targets to process subdirectories.
618 .IP "test (o)" 4
619 .IX Item "test (o)"
620 Defines the test targets.
621 .IP "test_via_harness (override)" 4
622 .IX Item "test_via_harness (override)"
623 For some reason which I forget, Unix machines like to have
624 PERL_DL_NONLAZY set for tests.
625 .IP "test_via_script (override)" 4
626 .IX Item "test_via_script (override)"
627 Again, the PERL_DL_NONLAZY thing.
628 .IP "tool_xsubpp (o)" 4
629 .IX Item "tool_xsubpp (o)"
630 Determines typemaps, xsubpp version, prototype behaviour.
631 .IP all_target 4
632 .IX Item "all_target"
633 Build man pages, too
634 .IP "top_targets (o)" 4
635 .IX Item "top_targets (o)"
636 Defines the targets all, subdirs, config, and O_FILES
637 .IP writedoc 4
638 .IX Item "writedoc"
639 Obsolete, deprecated method. Not used since Version 5.21.
640 .IP "xs_c (o)" 4
641 .IX Item "xs_c (o)"
642 Defines the suffix rules to compile XS files to C.
643 .IP "xs_cpp (o)" 4
644 .IX Item "xs_cpp (o)"
645 Defines the suffix rules to compile XS files to C++.
646 .IP "xs_o (o)" 4
647 .IX Item "xs_o (o)"
648 Defines suffix rules to go from XS to object files directly. This was
649 originally only intended for broken make implementations, but is now
650 necessary for per\-XS file under \f(CW\*(C`XSMULTI\*(C'\fR, since each XS file might
651 have an individual \f(CW\*(C`$(VERSION)\*(C'\fR.
652 .SH "SEE ALSO"
653 .IX Header "SEE ALSO"
654 ExtUtils::MakeMaker