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