Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 277 lines (188 sloc) 10.287 kb
cf69c17 MAJ 3.01
xleroy authored
1 Release notes on the MS Windows ports of Objective Caml
2 -------------------------------------------------------
3
648aa30 Nettoyages
xleroy authored
4 Starting with OCaml 3.05, there are no less than three ports of
1131ee4 MAJ portage MinGW
xleroy authored
5 Objective Caml for MS Windows available:
648aa30 Nettoyages
xleroy authored
6 - a native Win32 port, built with the Microsoft development tools;
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
7 - a native Win32 port, built with the Cygwin/MinGW development tools;
cf69c17 MAJ 3.01
xleroy authored
8 - a port consisting of the Unix sources compiled under the Cygwin
648aa30 Nettoyages
xleroy authored
9 Unix-like environment for Windows.
cf69c17 MAJ 3.01
xleroy authored
10
1131ee4 MAJ portage MinGW
xleroy authored
11 Here is a summary of the main differences between these ports:
cf69c17 MAJ 3.01
xleroy authored
12
648aa30 Nettoyages
xleroy authored
13 Native MS Native MinGW Cygwin
1131ee4 MAJ portage MinGW
xleroy authored
14 Third-party software required
648aa30 Nettoyages
xleroy authored
15 - for base bytecode system none none none
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
16 - for ocamlc -custom MSVC Cygwin Cygwin
17 - for native-code generation MSVC+MASM Cygwin Cygwin
cf69c17 MAJ 3.01
xleroy authored
18
648aa30 Nettoyages
xleroy authored
19 Speed of bytecode interpreter 70% 100% 100%
1131ee4 MAJ portage MinGW
xleroy authored
20
648aa30 Nettoyages
xleroy authored
21 Replay debugger no no yes
1131ee4 MAJ portage MinGW
xleroy authored
22
648aa30 Nettoyages
xleroy authored
23 The Unix library partial partial full
1131ee4 MAJ portage MinGW
xleroy authored
24
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
25 The Threads library yes yes yes
1131ee4 MAJ portage MinGW
xleroy authored
26
648aa30 Nettoyages
xleroy authored
27 The Graphics library yes yes no
1131ee4 MAJ portage MinGW
xleroy authored
28
82c273a MAJ et nettoyages
xleroy authored
29 Restrictions on generated executables? none none yes (*)
1131ee4 MAJ portage MinGW
xleroy authored
30
82c273a MAJ et nettoyages
xleroy authored
31 (*) Cygwin-generated .exe files refer to a DLL that is distributed under
32 the GPL. Thus, these .exe files can only be distributed under a license
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
33 that is compatible with the GPL. Executables generated by MSVC or by
82c273a MAJ et nettoyages
xleroy authored
34 MinGW have no such restrictions.
cf69c17 MAJ 3.01
xleroy authored
35
82c273a MAJ et nettoyages
xleroy authored
36 The remainder of this document gives more information on each port.
cf69c17 MAJ 3.01
xleroy authored
37
38 ------------------------------------------------------------------------------
39
1131ee4 MAJ portage MinGW
xleroy authored
40 The native Win32 port built with Microsoft Visual C
41 ---------------------------------------------------
d06f82e Blabla sur la version Windows
xleroy authored
42
43 REQUIREMENTS:
44
4c1dce3 MAJ instructions installation
xleroy authored
45 This port runs under MS Windows NT, 2000 and XP.
46 Windows 95, 98 and ME are also supported, but less reliably.
d06f82e Blabla sur la version Windows
xleroy authored
47
11d8fff Renommage en Objective Caml
xleroy authored
48 The base bytecode system (ocamlc, ocaml, ocamllex, ocamlyacc, ...)
49 runs without any additional tools.
d06f82e Blabla sur la version Windows
xleroy authored
50
9eaedc5 Chargement dynamique de primitives C
xleroy authored
51 Statically linking Caml bytecode with C code (ocamlc -custom) requires the
648aa30 Nettoyages
xleroy authored
52 Microsoft Visual C++ compiler. Dynamic loading of DLLs is
9eaedc5 Chargement dynamique de primitives C
xleroy authored
53 supported out of the box, without additional software.
d06f82e Blabla sur la version Windows
xleroy authored
54
648aa30 Nettoyages
xleroy authored
55 The native-code compiler (ocamlopt) requires Visual C++ and the
56 Microsoft assembler MASM version 6.11 or later. MASM can be
57 downloaded for free from Microsoft's Web site; for directions, see
5ccc0e3 detabisation
doligez authored
58 http://www.easystreet.com/~jkirwan/pctools.html
82c273a MAJ et nettoyages
xleroy authored
59 or http://www2.dgsys.com/~raymoon/faq/masm.html
60 or the comp.lang.asm.x86 FAQ.
d06f82e Blabla sur la version Windows
xleroy authored
61
551e55a MAJ pour version 3.02
xleroy authored
62 The LablTk GUI requires Tcl/Tk 8.3. Windows binaries are
82c273a MAJ et nettoyages
xleroy authored
63 available from http://prdownloads.sourceforge.net/tcl/tcl832.exe.
f577670 configure, INSTALL: option -with-pthread
xleroy authored
64
d06f82e Blabla sur la version Windows
xleroy authored
65
66 INSTALLATION:
67
1b438f1 MAJ
xleroy authored
68 The binary distribution is a self-installing executable archive.
69 Just run it and it should install OCaml automatically.
d06f82e Blabla sur la version Windows
xleroy authored
70
4c1dce3 MAJ instructions installation
xleroy authored
71 If you are using Windows 95, 98 or ME, you need to adjust environment
72 variables as follows:
73 - add the "bin" subdirectory of the OCaml installation directory
74 to the PATH variable;
75 - set the OCAMLLIB variable to the "lib" subdirectory of the
76 OCaml installation directory.
77 For instance, if you installed OCaml in C:\Program Files\Objective Caml,
33f4938 MAJ instructions Win98
xleroy authored
78 add the following two lines at the end of C:\autoexec.bat:
79
4c1dce3 MAJ instructions installation
xleroy authored
80 set PATH=%PATH%;"C:\Program Files\Objective Caml\bin"
33f4938 MAJ instructions Win98
xleroy authored
81 set OCAMLLIB=C:\Program Files\Objective Caml\lib
82
4c1dce3 MAJ instructions installation
xleroy authored
83 No such tweaking of environment variables is needed under NT, 2000 and XP.
84
3585fec MAJ install Windows
xleroy authored
85 To run programs that use the LablTK GUI, the directory where the
86 DLLs tk83.dll and tcl83.dll were installed (by the Tcl/Tk
87 installer) must be added to the PATH environment variable.
88
89 To compile programs that use the LablTK GUI, the directory where the
90 libraries tk83.lib and tcl83.lib were installed (by the Tcl/Tk
91 installer) must be added to the library search path in the LIB
92 environment variable. E.g. if Tcl/Tk was installed in C:\tcl, add
93 "C:\tcl\lib" to the LIB environment variable.
cf69c17 MAJ 3.01
xleroy authored
94
4c1dce3 MAJ instructions installation
xleroy authored
95
d06f82e Blabla sur la version Windows
xleroy authored
96 RECOMPILATION FROM THE SOURCES:
97
98 The command-line tools can be recompiled from the Unix source
11d8fff Renommage en Objective Caml
xleroy authored
99 distribution (ocaml-X.YZ.tar.gz), which also contains the files modified
d06f82e Blabla sur la version Windows
xleroy authored
100 for Windows.
101
9eaedc5 Chargement dynamique de primitives C
xleroy authored
102 You will need the following software components to perform the recompilation:
1131ee4 MAJ portage MinGW
xleroy authored
103 - Windows NT, 2000, or XP (we advise against compiling under Windows 95/98/ME)
648aa30 Nettoyages
xleroy authored
104 - Visual C++ version 6 or 7
9eaedc5 Chargement dynamique de primitives C
xleroy authored
105 - MASM version 6.11 (see above)
f791d48 Fusion des modifs faites sur la branche release jusqu'a la release 3.…
xleroy authored
106 - The Cygwin port of GNU tools, available from http://cygwin.com/
9eaedc5 Chargement dynamique de primitives C
xleroy authored
107 - TCL/TK version 8.3 (for the LablTK GUI) (see above).
d06f82e Blabla sur la version Windows
xleroy authored
108
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
109 Remember to add the directory where the libraries tk83.lib and
110 tcl83.lib were installed (by the Tcl/Tk installer) to the LIB variable
111 (library search path).
112
1131ee4 MAJ portage MinGW
xleroy authored
113 To recompile, start a Cygwin shell and change to the top-level
114 directory of the OCaml distribution. Then, do
115
5ccc0e3 detabisation
doligez authored
116 cp config/m-nt.h config/m.h
117 cp config/s-nt.h config/s.h
118 cp config/Makefile.msvc config/Makefile
f46ea68 MAJ. Description de la recompilation a partir des sources
xleroy authored
119
82c273a MAJ et nettoyages
xleroy authored
120 Then, edit config/Makefile as needed, following the comments in this file.
121 Normally, the only variables that need to be changed are
5ccc0e3 detabisation
doligez authored
122 PREFIX where to install everything
123 TK_ROOT where TCL/TK was installed
d06f82e Blabla sur la version Windows
xleroy authored
124
1131ee4 MAJ portage MinGW
xleroy authored
125 Finally, use "make -f Makefile.nt" to build the system, e.g.
126
127 make -f Makefile.nt world
128 make -f Makefile.nt bootstrap
129 make -f Makefile.nt opt
130 make -f Makefile.nt install
131
132
133 NOTES:
d06f82e Blabla sur la version Windows
xleroy authored
134
82c273a MAJ et nettoyages
xleroy authored
135 * The VC++ compiler does not implement "computed gotos", and therefore
648aa30 Nettoyages
xleroy authored
136 generates inefficient code for byterun/interp.c. Consequently, the
137 performance of bytecode programs is about 2/3 of that obtained under
1131ee4 MAJ portage MinGW
xleroy authored
138 Unix/GCC or Cygwin or Mingw on similar hardware.
90170a2 MAJ.
xleroy authored
139
9eb33db MAJ
xleroy authored
140 * Libraries available in this port: "num", "str", "threads", "graphics",
cf69c17 MAJ 3.01
xleroy authored
141 "labltk", and large parts of "unix".
d06f82e Blabla sur la version Windows
xleroy authored
142
1131ee4 MAJ portage MinGW
xleroy authored
143 * The replay debugger is not supported.
d06f82e Blabla sur la version Windows
xleroy authored
144
145 CREDITS:
146
11d8fff Renommage en Objective Caml
xleroy authored
147 The initial port of Caml Special Light (the ancestor of Objective Caml)
148 to Windows NT was done by Kevin Gallo at Microsoft Research, who
149 kindly contributed his changes to the Caml project.
d06f82e Blabla sur la version Windows
xleroy authored
150
f1d7182 Merge de OCamlWinPlus (Christopher Watford)
xleroy authored
151 The graphical user interface for the toplevel was initially developed
152 by Jacob Navia, then significantly improved by Christopher A. Watford.
1131ee4 MAJ portage MinGW
xleroy authored
153
154 ------------------------------------------------------------------------------
155
156 The native Win32 port built with Mingw
157 --------------------------------------
158
159 REQUIREMENTS:
160
4c1dce3 MAJ instructions installation
xleroy authored
161 This port runs under MS Windows NT, 2000 and XP.
162 Windows 95, 98 and ME are also supported, but less reliably.
1131ee4 MAJ portage MinGW
xleroy authored
163
164 The base bytecode system (ocamlc, ocaml, ocamllex, ocamlyacc, ...)
165 runs without any additional tools.
166
167 The native-code compiler (ocamlopt), as well as static linking of
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
168 Caml bytecode with C code (ocamlc -custom), require
169 the Cygwin development tools, available at
82c273a MAJ et nettoyages
xleroy authored
170 http://sources.redhat.com/cygwin/
1131ee4 MAJ portage MinGW
xleroy authored
171
82c273a MAJ et nettoyages
xleroy authored
172 The LablTk GUI requires Tcl/Tk 8.3. Windows binaries are
173 available from http://prdownloads.sourceforge.net/tcl/tcl832.exe.
1131ee4 MAJ portage MinGW
xleroy authored
174
175
176 INSTALLATION:
177
f791d48 Fusion des modifs faites sur la branche release jusqu'a la release 3.…
xleroy authored
178 The binary distribution is a self-installing executable archive.
179 Just run it and it should install OCaml automatically.
180
181 If you are using Windows 95, 98 or ME, you need to adjust environment
182 variables as follows:
183 - add the "bin" subdirectory of the OCaml installation directory
184 to the PATH variable;
185 - set the OCAMLLIB variable to the "lib" subdirectory of the
186 OCaml installation directory.
187 For instance, if you installed OCaml in C:\Program Files\Objective Caml,
188 add the following two lines at the end of C:\autoexec.bat:
189
190 set PATH=%PATH%;"C:\Program Files\Objective Caml\bin"
191 set OCAMLLIB=C:\Program Files\Objective Caml\lib
192
193 No such tweaking of environment variables is needed under NT, 2000 and XP.
194
195 To run programs that use the LablTK GUI, the directory where the
196 DLLs tk83.dll and tcl83.dll were installed (by the Tcl/Tk
197 installer) must be added to the PATH environment variable.
198
199 To compile programs that use the LablTK GUI, the directory where the
200 libraries tk83.lib and tcl83.lib were installed (by the Tcl/Tk
201 installer) must be added to the library search path in the LIB
202 environment variable. E.g. if Tcl/Tk was installed in C:\tcl, add
203 "C:\tcl\lib" to the LIB environment variable.
1131ee4 MAJ portage MinGW
xleroy authored
204
205
206 RECOMPILATION FROM THE SOURCES:
207
208 You will need the following software components to perform the recompilation:
209 - Windows NT, 2000, or XP (we advise against compiling under Windows 95/98/ME)
210 - Cygwin: http://sourceware.cygnus.com/cygwin/
82c273a MAJ et nettoyages
xleroy authored
211 - TCL/TK version 8.3 (see above).
1131ee4 MAJ portage MinGW
xleroy authored
212
786cf74 Clarification MinGW
xleroy authored
213 Do *not* install the standalone distribution of MinGW, nor the
214 companion MSYS tools: these have problems with long command lines.
215 Instead, use the version of MinGW that is installed along with Cygwin.
216
1131ee4 MAJ portage MinGW
xleroy authored
217 Start a Cygwin shell and unpack the source distribution
218 (ocaml-X.YZ.tar.gz) with "tar xzf". Change to the top-level
219 directory of the OCaml distribution. Then, do
220
5ccc0e3 detabisation
doligez authored
221 cp config/m-nt.h config/m.h
222 cp config/s-nt.h config/s.h
223 cp config/Makefile.mingw config/Makefile
1131ee4 MAJ portage MinGW
xleroy authored
224
82c273a MAJ et nettoyages
xleroy authored
225 Then, edit config/Makefile as needed, following the comments in this file.
226 Normally, the only variables that need to be changed are
5ccc0e3 detabisation
doligez authored
227 PREFIX where to install everything
228 TK_ROOT where TCL/TK was installed
1131ee4 MAJ portage MinGW
xleroy authored
229
230 Finally, use "make -f Makefile.nt" to build the system, e.g.
231
232 make -f Makefile.nt world
233 make -f Makefile.nt bootstrap
234 make -f Makefile.nt opt
235 make -f Makefile.nt opt.opt
82c273a MAJ et nettoyages
xleroy authored
236 make -f Makefile.nt install
1131ee4 MAJ portage MinGW
xleroy authored
237
238
239 NOTES:
240
241 * Libraries available in this port: "num", "str", "threads", "graphics",
242 "labltk", and large parts of "unix".
243
244 * The replay debugger is not supported.
82c273a MAJ et nettoyages
xleroy authored
245
246 ------------------------------------------------------------------------------
247
248 The Cygwin port of Objective Caml
249 ---------------------------------
250
251 REQUIREMENTS:
252
253 This port requires the Cygwin environment from Cygnus/RedHat, which
254 is freely available at:
255 http://sources.redhat.com/cygwin/
256
4c1dce3 MAJ instructions installation
xleroy authored
257 This port runs under all versions of MS Windows supported by Cygwin.
82c273a MAJ et nettoyages
xleroy authored
258
259
260 INSTALLATION:
261
f791d48 Fusion des modifs faites sur la branche release jusqu'a la release 3.…
xleroy authored
262 For technical reasons, no binary distribution of this port is available.
82c273a MAJ et nettoyages
xleroy authored
263 You need to recompile from the source distribution.
264
265
266 RECOMPILATION FROM THE SOURCES:
267
268 Just follow the instructions for Unix machines given in the file INSTALL.
269
270
271 NOTES:
272
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
273 The libraries available in this port are "num", "str", "threads",
f791d48 Fusion des modifs faites sur la branche release jusqu'a la release 3.…
xleroy authored
274 "unix" and "labltk". "graph" is not available.
82c273a MAJ et nettoyages
xleroy authored
275 The replay debugger is supported.
276
Something went wrong with that request. Please try again.