Debian Codegraph @

upstream/mageia-cauldron/man3pm/ExtUtils::MM_Win32.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_Win32 3pm"
61 .TH ExtUtils::MM_Win32 3pm 2025-06-24 "perl v5.42.0" "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_Win32 \- methods to override UN*X behaviour in ExtUtils::MakeMaker
68 .SH SYNOPSIS
69 .IX Header "SYNOPSIS"
70 .Vb 1
71 \& use ExtUtils::MM_Win32; # Done internally by ExtUtils::MakeMaker if needed
72 .Ve
73 .SH DESCRIPTION
74 .IX Header "DESCRIPTION"
75 See ExtUtils::MM_Unix for a documentation of the methods provided
76 there. This package overrides the implementation of these methods, not
77 the semantics.
78 .SS "Overridden methods"
79 .IX Subsection "Overridden methods"
80 .IP \fBdlsyms\fR 4
81 .IX Item "dlsyms"
82 .PD 0
83 .IP xs_dlsyms_ext 4
84 .IX Item "xs_dlsyms_ext"
85 .PD
86 On Win32, is \f(CW\*(C`.def\*(C'\fR.
87 .IP replace_manpage_separator 4
88 .IX Item "replace_manpage_separator"
89 Changes the path separator with .
90 .IP \fBmaybe_command\fR 4
91 .IX Item "maybe_command"
92 Since Windows has nothing as simple as an executable bit, we check the
93 file extension.
94 .Sp
95 The PATHEXT env variable will be used to get a list of extensions that
96 might indicate a command, otherwise .com, .exe, .bat and .cmd will be
97 used by default.
98 .IP \fBinit_DIRFILESEP\fR 4
99 .IX Item "init_DIRFILESEP"
100 Using \e for Windows, except for "gmake" where it is /.
101 .IP init_tools 4
102 .IX Item "init_tools"
103 Override some of the slower, portable commands with Windows specific ones.
104 .IP init_others 4
105 .IX Item "init_others"
106 Override the default link and compile tools.
107 .Sp
108 LDLOADLIBS\*(Aqs default is changed to \f(CW$Config\fR{libs}.
109 .Sp
110 Adjustments are made for Borland\*(Aqs quirks needing \-L to come first.
111 .IP init_platform 4
112 .IX Item "init_platform"
113 Add MM_Win32_VERSION.
114 .IP platform_constants 4
115 .IX Item "platform_constants"
116 .PD 0
117 .IP specify_shell 4
118 .IX Item "specify_shell"
119 .PD
120 Set SHELL to \f(CW$ENV\fR{COMSPEC} only if make is type \*(Aqgmake\*(Aq.
121 .IP constants 4
122 .IX Item "constants"
123 Add MAXLINELENGTH for dmake before all the constants are output.
124 .IP dep_constants 4
125 .IX Item "dep_constants"
126 Makes dependencies that work for nmake.
127 .IP special_targets 4
128 .IX Item "special_targets"
129 Add .USESHELL target for dmake.
130 .IP static_lib_pure_cmd 4
131 .IX Item "static_lib_pure_cmd"
132 Defines how to run the archive utility
133 .IP dynamic_lib 4
134 .IX Item "dynamic_lib"
135 Methods are overridden here: not dynamic_lib itself, but the utility
136 ones that do the OS\-specific work.
137 .IP extra_clean_files 4
138 .IX Item "extra_clean_files"
139 Clean out some extra dll.{base,exp} files which might be generated by
140 gcc. Otherwise, take out all *.pdb files.
141 .IP init_linker 4
142 .IX Item "init_linker"
143 .PD 0
144 .IP perl_script 4
145 .IX Item "perl_script"
146 .PD
147 Checks for the perl program under several common perl extensions.
148 .IP quote_dep 4
149 .IX Item "quote_dep"
150 .PD 0
151 .IP xs_obj_opt 4
152 .IX Item "xs_obj_opt"
153 .PD
154 Override to fixup \-o flags for MSVC.
155 .IP pasthru 4
156 .IX Item "pasthru"
157 All we send is \-nologo to nmake to prevent it from printing its damned
158 banner.
159 .IP "arch_check (override)" 4
160 .IX Item "arch_check (override)"
161 Normalize all arguments for consistency of comparison.
162 .IP oneliner 4
163 .IX Item "oneliner"
164 These are based on what command.com does on Win98. They may be wrong
165 for other Windows shells, I don\*(Aqt know.
166 .IP cd 4
167 .IX Item "cd"
168 dmake can handle Unix style cd\*(Aqing but nmake (at least 1.5) cannot. It
169 wants:
170 .Sp
171 .Vb 4
172 \& cd dir1\edir2
173 \& command
174 \& another_command
175 \& cd ..\e..
176 .Ve
177 .IP max_exec_len 4
178 .IX Item "max_exec_len"
179 nmake 1.50 limits command length to 2048 characters.
180 .IP os_flavor 4
181 .IX Item "os_flavor"
182 Windows is Win32.
183 .IP dbgoutflag 4
184 .IX Item "dbgoutflag"
185 Returns a CC flag that tells the CC to emit a separate debugging symbol file
186 when compiling an object file.
187 .IP cflags 4
188 .IX Item "cflags"
189 Defines the PERLDLL symbol if we are configured for static building since all
190 code destined for the perl5xx.dll must be compiled with the PERLDLL symbol
191 defined.
192 .IP make_type 4
193 .IX Item "make_type"
194 Returns a suitable string describing the type of makefile being written.