[OpenSPARC-T2-SAM] / sam-t2 / devtools / v8plus / man / man3 / ExtUtils::MM_Win32.3

.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "ExtUtils::MM_Win32 3"
.TH ExtUtils::MM_Win32 3 "2001-09-21" "perl v5.8.8" "Perl Programmers Reference Guide"
.SH "NAME"
ExtUtils::MM_Win32 \- methods to override UN*X behaviour in ExtUtils::MakeMaker
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& use ExtUtils::MM_Win32; # Done internally by ExtUtils::MakeMaker if needed
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
See ExtUtils::MM_Unix for a documentation of the methods provided
there. This package overrides the implementation of these methods, not
the semantics.
.Sh "Overridden methods"
.IX Subsection "Overridden methods"
.IP "\fBdlsyms\fR" 4
.IX Item "dlsyms"
.PD 0
.IP "replace_manpage_separator" 4
.IX Item "replace_manpage_separator"
.PD
Changes the path separator with .
.IP "\fBmaybe_command\fR" 4
.IX Item "maybe_command"
Since Windows has nothing as simple as an executable bit, we check the
file extension.
.Sp
The \s-1PATHEXT\s0 env variable will be used to get a list of extensions that
might indicate a command, otherwise .com, .exe, .bat and .cmd will be
used by default.
.IP "\fBinit_DIRFILESEP\fR" 4
.IX Item "init_DIRFILESEP"
Using \e for Windows.
.IP "\fBinit_others\fR" 4
.IX Item "init_others"
Override some of the Unix specific commands with portable
ExtUtils::Command ones.
.Sp
Also provide defaults for \s-1LD\s0 and \s-1AR\s0 in case the \f(CW%Config\fR values aren't
set.
.Sp
\&\s-1LDLOADLIBS\s0's default is changed to \f(CW$Config\fR{libs}.
.Sp
Adjustments are made for Borland's quirks needing \-L to come first.
.IP "init_platform" 4
.IX Item "init_platform"
Add MM_Win32_VERSION.
.IP "platform_constants" 4
.IX Item "platform_constants"
.PD 0
.IP "special_targets" 4
.IX Item "special_targets"
.PD
Add .USESHELL target for dmake.
.IP "static_lib" 4
.IX Item "static_lib"
Changes how to run the linker.
.Sp
The rest is duplicate code from MM_Unix.  Should move the linker code
to its own method.
.IP "dynamic_lib" 4
.IX Item "dynamic_lib"
Complicated stuff for Win32 that I don't understand. :(
.IP "extra_clean_files" 4
.IX Item "extra_clean_files"
Clean out some extra dll.{base,exp} files which might be generated by
gcc.  Otherwise, take out all *.pdb files.
.IP "init_linker" 4
.IX Item "init_linker"
.PD 0
.IP "perl_script" 4
.IX Item "perl_script"
.PD
Checks for the perl program under several common perl extensions.
.IP "xs_o" 4
.IX Item "xs_o"
This target is stubbed out.  Not sure why.
.IP "pasthru" 4
.IX Item "pasthru"
All we send is \-nologo to nmake to prevent it from printing its damned
banner.
.IP "oneliner" 4
.IX Item "oneliner"
These are based on what command.com does on Win98.  They may be wrong
for other Windows shells, I don't know.
.IP "cd" 4
.IX Item "cd"
dmake can handle Unix style cd'ing but nmake (at least 1.5) cannot.  It
wants:
.Sp
.Vb 4
\&    cd dir
\&    command
\&    another_command
\&    cd ..
.Ve
.Sp
\&\fB\s-1NOTE\s0\fR This cd can only go one level down.  So far this sufficient for
what MakeMaker needs.
.IP "max_exec_len" 4
.IX Item "max_exec_len"
nmake 1.50 limits command length to 2048 characters.
.IP "os_flavor" 4
.IX Item "os_flavor"
Windows is Win32.
Commit	Line	Data
920dae64 AT	1	.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
	2	.\"
	3	.\" Standard preamble:
	4	.\" ========================================================================
	5	.de Sh \" Subsection heading
	6	.br
	7	.if t .Sp
	8	.ne 5
	9	.PP
	10	\fB\\$1\fR
	11	.PP
	12	..
	13	.de Sp \" Vertical space (when we can't use .PP)
	14	.if t .sp .5v
	15	.if n .sp
	16	..
	17	.de Vb \" Begin verbatim text
	18	.ft CW
	19	.nf
	20	.ne \\$1
	21	..
	22	.de Ve \" End verbatim text
	23	.ft R
	24	.fi
	25	..
	26	.\" Set up some character translations and predefined strings. \*(-- will
	27	.\" give an unbreakable dash, \(PI will give pi, \(L" will give a left
	28	.\" double quote, and \*(R" will give a right double quote. \| will give a
	29	.\" real vertical bar. \*(C+ will give a nicer C++. Capital omega is used to
	30	.\" do unbreakable dashes and therefore won't be available. \(C` and \(C'
	31	.\" expand to `' in nroff, nothing in troff, for use with C<>.
	32	.tr \(W-\|\(bv\(Tr
	33	.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
	34	.ie n \{\
	35	. ds -- \(*W-
	36	. ds PI pi
	37	. if (\n(.H=4u)&(1m=24u) .ds -- \(W\h'-12u'\(W\h'-12u'-\" diablo 10 pitch
	38	. if (\n(.H=4u)&(1m=20u) .ds -- \(W\h'-12u'\(W\h'-8u'-\" diablo 12 pitch
	39	. ds L" ""
	40	. ds R" ""
	41	. ds C` ""
	42	. ds C' ""
	43	'br\}
	44	.el\{\
	45	. ds -- \\|\(em\\|
	46	. ds PI \(*p
	47	. ds L" ``
	48	. ds R" ''
	49	'br\}
	50	.\"
	51	.\" If the F register is turned on, we'll generate index entries on stderr for
	52	.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
	53	.\" entries marked with X<> in POD. Of course, you'll have to process the
	54	.\" output yourself in some meaningful fashion.
	55	.if \nF \{\
	56	. de IX
	57	. tm Index:\\$1\t\\n%\t"\\$2"
	58	..
	59	. nr % 0
	60	. rr F
	61	.\}
	62	.\"
	63	.\" For nroff, turn off justification. Always turn off hyphenation; it makes
	64	.\" way too many mistakes in technical documents.
65	.hy 0
66	.if n .na
67	.\"
68	.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69	.\" Fear. Run. Save yourself. No user-serviceable parts.
70	. \" fudge factors for nroff and troff
71	.if n \{\
72	. ds #H 0
73	. ds #V .8m
74	. ds #F .3m
75	. ds #[ \f1
76	. ds #] \fP
77	.\}
78	.if t \{\
79	. ds #H ((1u-(\\\\n(.fu%2u))*.13m)
80	. ds #V .6m
81	. ds #F 0
82	. ds #[ \&
83	. ds #] \&
84	.\}
85	. \" simple accents for nroff and troff
86	.if n \{\
87	. ds ' \&
88	. ds ` \&
89	. ds ^ \&
90	. ds , \&
91	. ds ~ ~
92	. ds /
93	.\}
94	.if t \{\
95	. ds ' \\k:\h'-(\\n(.wu8/10-\(#H)'\'\h"\|\\n:u"
96	. ds ` \\k:\h'-(\\n(.wu8/10-\(#H)'\`\h'\|\\n:u'
97	. ds ^ \\k:\h'-(\\n(.wu10/11-\(#H)'^\h'\|\\n:u'
98	. ds , \\k:\h'-(\\n(.wu*8/10)',\h'\|\\n:u'
99	. ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'\|\\n:u'
100	. ds / \\k:\h'-(\\n(.wu8/10-\(#H)'\z\(sl\h'\|\\n:u'
101	.\}
102	. \" troff and (daisy-wheel) nroff accents
103	.ds : \\k:\h'-(\\n(.wu8/10-\(#H+.1m+\(#F)'\v'-\(#V'\z.\h'.2m+\(#F'.\h'\|\\n:u'\v'\(#V'
104	.ds 8 \h'\(#H'\(b\h'-\*(#H'
105	.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\(#H)/2u'\v'-.3n'\(#[\z\(de\v'.3n'\h'\|\\n:u'\*(#]
106	.ds d- \h'\(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\(#H'
107	.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'\|\\n:u'
108	.ds th \(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u2/3)'\s-1o\s+1\*(#]
109	.ds Th \(#[\s+2I\s-2\h'-\w'I'u3/5'\v'-.3m'o\v'.3m'\*(#]
110	.ds ae a\h'-(\w'a'u*4/10)'e
111	.ds Ae A\h'-(\w'A'u*4/10)'E
112	. \" corrections for vroff
113	.if v .ds ~ \\k:\h'-(\\n(.wu9/10-\(#H)'\s-2\u~\d\s+2\h'\|\\n:u'
114	.if v .ds ^ \\k:\h'-(\\n(.wu10/11-\(#H)'\v'-.4m'^\v'.4m'\h'\|\\n:u'
115	. \" for low resolution devices (crt and lpr)
116	.if \n(.H>23 .if \n(.V>19 \
117	\{\
118	. ds : e
119	. ds 8 ss
120	. ds o a
121	. ds d- d\h'-1'\(ga
122	. ds D- D\h'-1'\(hy
123	. ds th \o'bp'
124	. ds Th \o'LP'
125	. ds ae ae
126	. ds Ae AE
127	.\}
128	.rm #[ #] #H #V #F C
129	.\" ========================================================================
130	.\"
131	.IX Title "ExtUtils::MM_Win32 3"
132	.TH ExtUtils::MM_Win32 3 "2001-09-21" "perl v5.8.8" "Perl Programmers Reference Guide"
133	.SH "NAME"
134	ExtUtils::MM_Win32 \- methods to override UN*X behaviour in ExtUtils::MakeMaker
135	.SH "SYNOPSIS"
136	.IX Header "SYNOPSIS"
137	.Vb 1
138	\& use ExtUtils::MM_Win32; # Done internally by ExtUtils::MakeMaker if needed
139	.Ve
140	.SH "DESCRIPTION"
141	.IX Header "DESCRIPTION"
142	See ExtUtils::MM_Unix for a documentation of the methods provided
143	there. This package overrides the implementation of these methods, not
144	the semantics.
145	.Sh "Overridden methods"
146	.IX Subsection "Overridden methods"
147	.IP "\fBdlsyms\fR" 4
148	.IX Item "dlsyms"
149	.PD 0
150	.IP "replace_manpage_separator" 4
151	.IX Item "replace_manpage_separator"
152	.PD
153	Changes the path separator with .
154	.IP "\fBmaybe_command\fR" 4
155	.IX Item "maybe_command"
156	Since Windows has nothing as simple as an executable bit, we check the
157	file extension.
158	.Sp
159	The \s-1PATHEXT\s0 env variable will be used to get a list of extensions that
160	might indicate a command, otherwise .com, .exe, .bat and .cmd will be
161	used by default.
162	.IP "\fBinit_DIRFILESEP\fR" 4
163	.IX Item "init_DIRFILESEP"
164	Using \e for Windows.
165	.IP "\fBinit_others\fR" 4
166	.IX Item "init_others"
167	Override some of the Unix specific commands with portable
168	ExtUtils::Command ones.
169	.Sp
170	Also provide defaults for \s-1LD\s0 and \s-1AR\s0 in case the \f(CW%Config\fR values aren't
171	set.
172	.Sp
173	\&\s-1LDLOADLIBS\s0's default is changed to \f(CW$Config\fR{libs}.
174	.Sp
175	Adjustments are made for Borland's quirks needing \-L to come first.
176	.IP "init_platform" 4
177	.IX Item "init_platform"
178	Add MM_Win32_VERSION.
179	.IP "platform_constants" 4
180	.IX Item "platform_constants"
181	.PD 0
182	.IP "special_targets" 4
183	.IX Item "special_targets"
184	.PD
185	Add .USESHELL target for dmake.
186	.IP "static_lib" 4
187	.IX Item "static_lib"
188	Changes how to run the linker.
189	.Sp
190	The rest is duplicate code from MM_Unix. Should move the linker code
191	to its own method.
192	.IP "dynamic_lib" 4
193	.IX Item "dynamic_lib"
194	Complicated stuff for Win32 that I don't understand. :(
195	.IP "extra_clean_files" 4
196	.IX Item "extra_clean_files"
197	Clean out some extra dll.{base,exp} files which might be generated by
198	gcc. Otherwise, take out all *.pdb files.
199	.IP "init_linker" 4
200	.IX Item "init_linker"
201	.PD 0
202	.IP "perl_script" 4
203	.IX Item "perl_script"
204	.PD
205	Checks for the perl program under several common perl extensions.
206	.IP "xs_o" 4
207	.IX Item "xs_o"
208	This target is stubbed out. Not sure why.
209	.IP "pasthru" 4
210	.IX Item "pasthru"
211	All we send is \-nologo to nmake to prevent it from printing its damned
212	banner.
213	.IP "oneliner" 4
214	.IX Item "oneliner"
215	These are based on what command.com does on Win98. They may be wrong
216	for other Windows shells, I don't know.
217	.IP "cd" 4
218	.IX Item "cd"
219	dmake can handle Unix style cd'ing but nmake (at least 1.5) cannot. It
220	wants:
221	.Sp
222	.Vb 4
223	\& cd dir
224	\& command
225	\& another_command
226	\& cd ..
227	.Ve
228	.Sp
229	\&\fB\s-1NOTE\s0\fR This cd can only go one level down. So far this sufficient for
230	what MakeMaker needs.
231	.IP "max_exec_len" 4
232	.IX Item "max_exec_len"
233	nmake 1.50 limits command length to 2048 characters.
234	.IP "os_flavor" 4
235	.IX Item "os_flavor"
236	Windows is Win32.