Debian Codegraph @

upstream/debian-unstable/man3/ExtUtils::MM_Win32.3perl

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