Skip to content
Newer
Older
100644 246 lines (158 sloc) 6.78 KB
fac1042 @bschmalhofer Added a couple of Id-tags for SVN.
bschmalhofer authored Jul 24, 2005
1
5ffaa36 @coke [docs] update filename so the perldoc hint actually works.
coke authored Nov 5, 2008
2 This file is best viewed with "perldoc README_win32".
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
3
4 =head1 NAME
5
6 README.win32 - Parrot under Windows
7
8 =head1 SYNOPSIS
9
10 These are instructions for building the "native" port of Parrot under
11 Windows 2000/XP on the Intel x86 architecture.
12
13 =head1 DESCRIPTION
14
15 Win32 "native" ports require no additional software to run but the
16 operating system. There should be other READMEs for (emulation)
17 systems that run on Win32, eg Cygwin.
18
19 Native compilers include:
20
6e2d16a @fperrad update some version:
fperrad authored Aug 17, 2006
21 Borland C++ (bcc) version xxx or later
22 Microsoft Visual C++ (cl) version 13.10.3077 or later
23 MinGW32 with GCC (gcc) version 3.4.2 or later
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
24 Intel C++ (icl) version 8.0.48 works
25
26 =head2 Setting Up Parrot
27
28 =over
29
30 =item Make
31
6a2ea71 @chromatic Note that nmake 1.5 will not build Parrot (patch from Nigel Sandever,
chromatic authored Jun 2, 2005
32 You need "nmake" to build Parrot under Windows with Microsoft compilers. It
33 should be available via Microsoft Visual Studio .NET 2003 or the Microsoft .NET
34 Framework SDK 1.1. Download the latter from the Microsoft .NET Framework
35 Homepage L<http://msdn.microsoft.com/netframework/>.
36
37 Note: Parrot will not build using nmake v1.5 from the MS web site. Download
38 one of the above toolkits to obtain a later version, either v7 or v8.
2deaca8 add urls for nnake
Leopold Toetsch authored May 9, 2004
39
f8b2d07 @fperrad update version for mingw
fperrad authored May 15, 2007
40 MinGW works with its GNU "make" (v 3.81) port and its name is
7db34d8 @fperrad update with ICU 3.6
fperrad authored Jan 18, 2007
41 'mingw32-make.exe'. If you also have the Minimal SYStem (MSYS) installed,
a8303de @jnthn Describe a possible MinGW/MSVC++ build issue in the Win32 build readm…
jnthn authored Dec 19, 2006
42 you will need to remove the Msys/bin folder from your PATH environment
43 variable before calling "perl Configure.pl" and mingw32-make. Perl detects
7db34d8 @fperrad update with ICU 3.6
fperrad authored Jan 18, 2007
44 and calls /bin/sh.exe, if found, whenever shelling a new process. sh.exe
45 causes problems for mingw32-make.exe because of its inability to handle
a8303de @jnthn Describe a possible MinGW/MSVC++ build issue in the Win32 build readm…
jnthn authored Dec 19, 2006
46 Windows pathnames with backslashes. You must run "perl Configure.pl" and
47 mingw32-make from a dosbox; running those commands from an MSYS shell window
48 will experience the same backslash path problems.
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
49
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
50 =item Command Shell
51
52 The surest way to build it is on Windows NT/2000/XP, using the cmd shell.
53
54 =item ICU
55
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
56 Parrot no longer comes with its own ICU, thus you need to install it on your
57 system if you want to use it. Note that ICU is now optional, you can
58 build Parrot without it, by not installing it or asking Parrot to
6e8ac99 @particle [CAGE]: entropy reduction on root files (bitrot--)
particle authored Jul 11, 2006
59 ignore it (C<--without-icu>).
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
60
61 If you want to use ICU, download it from
edfb6af @fperrad [doc] update ICU download URL
fperrad authored Jun 5, 2009
62 L<http://site.icu-project.org/download>.
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
63
64 If you want to use precompiled binaries, do the following.
65 Download the package matching your compiler, unpack it (say, into
66 C:\usr\lib), add the F<bin> directory to C<PATH>, and tell
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
67 Configure.pl to use it.
68
69 mkdir C:\usr\lib
f7742c1 @fperrad [win32] update some versions & links
fperrad authored Jan 9, 2010
70 unzip icu4c-4_2_1-Win32-msvc9.zip -d C:\usr\lib
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
71 mkdir C:\usr\lib\data
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
72 set PATH=%PATH%;C:\usr\lib\icu\bin
73 cd <parrot directory>
67c929f @ambs While discussion continues on p2, pod files should be at most
ambs authored Aug 22, 2006
74 perl Configure.pl
75 --icushared="C:\usr\lib\icu\lib\icudt.lib C:\usr\lib\icu\lib\icuuc.lib"
76 --icuheaders="C:\usr\lib\icu\include"
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
77
78 Note the step of creating the F<C:\usr\lib\data> directory, as Parrot
79 really wants it and the binary packages don't contain it. It doesn't
80 need to contain anything though, as the data is pulled in from
81 F<lib/icudt.lib>, which contains the standard data in binary form.
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
82
2ce7523 @jhoblitt change the spelling of librairies to libraries in README.win32, patch…
jhoblitt authored Oct 10, 2005
83 =item Optional libraries
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
84
2ce7523 @jhoblitt change the spelling of librairies to libraries in README.win32, patch…
jhoblitt authored Oct 10, 2005
85 The availability of these libraries is checked by Configure.pl.
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
86
3bfae37 @fperrad [gettext]
fperrad authored Apr 16, 2008
87 B<gettext> - library and tools for native language support
88 L<http://gnuwin32.sourceforge.net/>
89
6e8ac99 @particle [CAGE]: entropy reduction on root files (bitrot--)
particle authored Jul 11, 2006
90 B<GMP> - GNU multiple precision arithmetic library
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
91 L<http://developer.berlios.de/projects/win32gmp/>
92
b4a3428 @fperrad [win32]
fperrad authored Jan 20, 2009
93 B<OpenGL> / B<GLUT> - Open Graphics Library
94 L<http://www.xmission.com/~nate/glut.html> or
95 L<http://www.transmissionzero.co.uk/computing/using-glut-with-mingw/>
96
6e8ac99 @particle [CAGE]: entropy reduction on root files (bitrot--)
particle authored Jul 11, 2006
97 B<pcre> - Perl-Compatible Regular Expression library
9cbca78 @particle This small patch enables t/library/pcre.t on Win32.
particle authored Sep 30, 2005
98 L<http://gnuwin32.sourceforge.net/>
99
11c2d35 @fperrad readline with MinGW32.
fperrad authored Mar 6, 2006
100 B<readline> - edit command lines
101 L<http://gnuwin32.sourceforge.net/>
102
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
103 =item Optional utilities
104
e057167 @fperrad [docs]
fperrad authored Mar 16, 2007
105 The availability of these utilities is checked by Configure.pl
106 or by some test.
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
107
6e8ac99 @particle [CAGE]: entropy reduction on root files (bitrot--)
particle authored Jul 11, 2006
108 B<antlr> - ANother Tool for Language Recognition
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
109 L<http://www.antlr.org/>
110
00c2e22 @fperrad [win32]
fperrad authored Jan 20, 2009
111 B<ctags> - Exuberant Ctags
112 L<http://ctags.sourceforge.net/>
e057167 @fperrad [docs]
fperrad authored Mar 16, 2007
113
a823065 [perl #34625] [PATCH] make setup on MSWin32
Leopold Toetsch authored Apr 6, 2005
114 =item Inno Setup
115
116 Inno Setup is a I<free> installer for Windows programs.
117
f7742c1 @fperrad [win32] update some versions & links
fperrad authored Jan 9, 2010
118 The latest release of Inno Setup at the time of writing is 5.3.7.
a823065 [perl #34625] [PATCH] make setup on MSWin32
Leopold Toetsch authored Apr 6, 2005
119
120 The HomePage is on L<http://www.jrsoftware.org/>.
121
122 Add the directory to PATH.
123
124 set PATH=%PATH%;C:\Program Files\Inno Setup 5
125
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
126 =item Borland C++
127
128 XXX
129
130 =item Microsoft Visual C++
131
132 Since mid April 2004, Visual C++ comes in two flavors. Microsoft
133 Visual Studio .NET 2003 (L<http://msdn.microsoft.com/visualc/>), which
134 includes the full blown IDE, and Microsoft Visual C++ Toolkit 2003
135 (L<http://msdn.microsoft.com/visualc/vctoolkit2003/>), which is a free
136 (but unsupported) package, containing only the basic compiler and
137 linker stuff.
138
b252594 @coke Add some notes about compiling with the MS toolkit.
coke authored Oct 27, 2005
139 If you use the Toolkit, be sure to follow the directions for setting up
140 your build environment that come with the perl distributions. (README.win32
6e8ac99 @particle [CAGE]: entropy reduction on root files (bitrot--)
particle authored Jul 11, 2006
141 in the latest perl distribution.) You may have to substitute "Microsoft
142 Platform SDK" wherever "Microsoft SDK" is listed, depending on the your
b252594 @coke Add some notes about compiling with the MS toolkit.
coke authored Oct 27, 2005
143 install. You can ignore the entries regarding "win32/config.vc", but be sure
144 to create the "link.bat" batch file. Copy the missing files mentioned,
145 run the Toolkit Command Prompt, set the appropriate env vars, and you
146 should be fine. (For env vars, you can update them under My Computer->
147 properties so they are available whenever you open a shell.)
148
149 Note: It is possible to use ActiveState Perl with the Toolkit: you don't
150 have to compile your own perl.
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
151
a89f2f2 @coke Update information regarding strawberry perl build.
coke authored Jun 14, 2008
152 =item Strawberry Perl
153
154 With the Strawberry perl distro from
155 L<http://strawberryperl.com/>, gcc is included. To build parrot,
156 use the strawberry perl binary to run Configure.pl, and then
157 follow the directions.
158
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
159 =item MinGW32 with GCC
160
f7742c1 @fperrad [win32] update some versions & links
fperrad authored Jan 9, 2010
161 The latest release of MinGW package at the time of writing is 5.1.6,
1c3199a @fperrad [win32]
fperrad authored Apr 17, 2008
162 which contains gcc-3.4.5 as current release.
7595ae8 @fperrad - more details on MinGW gcc version
fperrad authored Sep 26, 2007
163 It can be downloaded here:
f7742c1 @fperrad [win32] update some versions & links
fperrad authored Jan 9, 2010
164 L<http://sourceforge.net/projects/mingw/files/>
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
165
166 The HomePage is on L<http://www.mingw.org/>.
167
ba3fbfb @fperrad [win32]
fperrad authored Mar 10, 2008
168 With the ActiveState Perl distribution, tell Configure.pl to use gcc :
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
169
67c929f @ambs While discussion continues on p2, pod files should be at most
ambs authored Aug 22, 2006
170 perl Configure.pl
171 --cc=gcc
172 --icushared="C:\usr\lib\icu\lib\icudt.lib C:\usr\lib\icu\lib\icuuc.lib"
173 --icuheaders="C:\usr\lib\icu\include"
4c8240c @chromatic Applied filepath fixes in patch #34986 from Francois Perrad.
chromatic authored Apr 15, 2005
174 or
175 perl Configure.pl --cc=gcc --without-icu
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
176
177 =item Intel C++
178
179 XXX
180
181 =back
182
183 =head2 Building
184
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
185 $MAKE
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
186
187 =head2 Testing
188
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
189 $MAKE test
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
190
191 =head2 Installation
192
df4b1f7 [perl #33924] [PATCH] Build on Win32 with MinGW
Leopold Toetsch authored Jan 26, 2005
193 $MAKE install
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
194
a823065 [perl #34625] [PATCH] make setup on MSWin32
Leopold Toetsch authored Apr 6, 2005
195 =head2 Installer
196
197 $MAKE win32-inno-installer
6e8ac99 @particle [CAGE]: entropy reduction on root files (bitrot--)
particle authored Jul 11, 2006
198
199 This command creates a setup-parrot-x.y.z.exe that contains all parrot install
a823065 [perl #34625] [PATCH] make setup on MSWin32
Leopold Toetsch authored Apr 6, 2005
200 directories.
201
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
202 =head2 Usage Hints
203
204 XXX
205
206 =head1 BUGS AND CAVEATS
207
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
208 =over
209
210 =item Features
211
212 Threads, Events, and Signals are missing.
213
214 =back
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
215
216 =head1 ACKNOWLEDGEMENTS
217
218 XXX
219
220 =head1 AUTHORS
221
222 =over
223
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
224 =item Ron Blaschke E<lt>ron@rblasch.orgE<gt>
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
225
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
226 =item François Perrad E<lt>francois.perrad@gadz.orgE<gt>
227
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
228 =back
229
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
230 This document is maintained by The Parrot Developers
66ddda2 @Infinoid [docs] Fix up old references to submitting/subscribing/archives for t…
Infinoid authored Feb 9, 2009
231 (E<lt>parrot-dev@lists.parrot.orgE<gt>).
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
232
233 =head1 SEE ALSO
234
235 L<parrot>
236
237 =head1 HISTORY
238
26edb66 @chromatic Documentation patch #34986 from Ron Blaschke.
chromatic authored Apr 14, 2005
239 This document borrows heavily from Perl's README.win32.
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
240
8733f48 [perl #36065] [PATCH] README.win32
Leopold Toetsch authored Jun 1, 2005
241 GCC/mingw32 support was added in 0.1.2 (François Perrad).
242
00c2e22 @fperrad [win32]
fperrad authored Jan 20, 2009
243 Last updated: 20 Jan 2009
d7c2759 [perl #29441] [PATCH] MSWin32 Docs
Leopold Toetsch authored May 9, 2004
244
245 =cut
Something went wrong with that request. Please try again.