Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 253 lines (169 sloc) 9.116 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)
106 - The CygWin port of GNU tools, available from
107 http://sourceware.cygnus.com/cygwin/
108 - TCL/TK version 8.3 (for the LablTK GUI) (see above).
d06f82e Blabla sur la version Windows
xleroy authored
109
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
110 Remember to add the directory where the libraries tk83.lib and
111 tcl83.lib were installed (by the Tcl/Tk installer) to the LIB variable
112 (library search path).
113
1131ee4 MAJ portage MinGW
xleroy authored
114 To recompile, start a Cygwin shell and change to the top-level
115 directory of the OCaml distribution. Then, do
116
5ccc0e3 detabisation
doligez authored
117 cp config/m-nt.h config/m.h
118 cp config/s-nt.h config/s.h
119 cp config/Makefile.msvc config/Makefile
f46ea68 MAJ. Description de la recompilation a partir des sources
xleroy authored
120
82c273a MAJ et nettoyages
xleroy authored
121 Then, edit config/Makefile as needed, following the comments in this file.
122 Normally, the only variables that need to be changed are
5ccc0e3 detabisation
doligez authored
123 PREFIX where to install everything
124 TK_ROOT where TCL/TK was installed
d06f82e Blabla sur la version Windows
xleroy authored
125
1131ee4 MAJ portage MinGW
xleroy authored
126 Finally, use "make -f Makefile.nt" to build the system, e.g.
127
128 make -f Makefile.nt world
129 make -f Makefile.nt bootstrap
130 make -f Makefile.nt opt
131 make -f Makefile.nt install
132
133
134 NOTES:
d06f82e Blabla sur la version Windows
xleroy authored
135
82c273a MAJ et nettoyages
xleroy authored
136 * The VC++ compiler does not implement "computed gotos", and therefore
648aa30 Nettoyages
xleroy authored
137 generates inefficient code for byterun/interp.c. Consequently, the
138 performance of bytecode programs is about 2/3 of that obtained under
1131ee4 MAJ portage MinGW
xleroy authored
139 Unix/GCC or Cygwin or Mingw on similar hardware.
90170a2 MAJ.
xleroy authored
140
9eb33db MAJ
xleroy authored
141 * Libraries available in this port: "num", "str", "threads", "graphics",
cf69c17 MAJ 3.01
xleroy authored
142 "labltk", and large parts of "unix".
d06f82e Blabla sur la version Windows
xleroy authored
143
1131ee4 MAJ portage MinGW
xleroy authored
144 * The replay debugger is not supported.
d06f82e Blabla sur la version Windows
xleroy authored
145
146 CREDITS:
147
11d8fff Renommage en Objective Caml
xleroy authored
148 The initial port of Caml Special Light (the ancestor of Objective Caml)
149 to Windows NT was done by Kevin Gallo at Microsoft Research, who
150 kindly contributed his changes to the Caml project.
d06f82e Blabla sur la version Windows
xleroy authored
151
9eb33db MAJ
xleroy authored
152 The graphical user interface for the toplevel is due to Jacob Navia.
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
82c273a MAJ et nettoyages
xleroy authored
178 There is no binary distribution yet, so please follow the compilation
179 instructions below.
1131ee4 MAJ portage MinGW
xleroy authored
180
181
182 RECOMPILATION FROM THE SOURCES:
183
184 You will need the following software components to perform the recompilation:
185 - Windows NT, 2000, or XP (we advise against compiling under Windows 95/98/ME)
186 - Cygwin: http://sourceware.cygnus.com/cygwin/
82c273a MAJ et nettoyages
xleroy authored
187 - TCL/TK version 8.3 (see above).
1131ee4 MAJ portage MinGW
xleroy authored
188
786cf74 Clarification MinGW
xleroy authored
189 Do *not* install the standalone distribution of MinGW, nor the
190 companion MSYS tools: these have problems with long command lines.
191 Instead, use the version of MinGW that is installed along with Cygwin.
192
1131ee4 MAJ portage MinGW
xleroy authored
193 Start a Cygwin shell and unpack the source distribution
194 (ocaml-X.YZ.tar.gz) with "tar xzf". Change to the top-level
195 directory of the OCaml distribution. Then, do
196
5ccc0e3 detabisation
doligez authored
197 cp config/m-nt.h config/m.h
198 cp config/s-nt.h config/s.h
199 cp config/Makefile.mingw config/Makefile
1131ee4 MAJ portage MinGW
xleroy authored
200
82c273a MAJ et nettoyages
xleroy authored
201 Then, edit config/Makefile as needed, following the comments in this file.
202 Normally, the only variables that need to be changed are
5ccc0e3 detabisation
doligez authored
203 PREFIX where to install everything
204 TK_ROOT where TCL/TK was installed
1131ee4 MAJ portage MinGW
xleroy authored
205
206 Finally, use "make -f Makefile.nt" to build the system, e.g.
207
208 make -f Makefile.nt world
209 make -f Makefile.nt bootstrap
210 make -f Makefile.nt opt
211 make -f Makefile.nt opt.opt
82c273a MAJ et nettoyages
xleroy authored
212 make -f Makefile.nt install
1131ee4 MAJ portage MinGW
xleroy authored
213
214
215 NOTES:
216
217 * Libraries available in this port: "num", "str", "threads", "graphics",
218 "labltk", and large parts of "unix".
219
220 * The replay debugger is not supported.
82c273a MAJ et nettoyages
xleroy authored
221
222 ------------------------------------------------------------------------------
223
224 The Cygwin port of Objective Caml
225 ---------------------------------
226
227 REQUIREMENTS:
228
229 This port requires the Cygwin environment from Cygnus/RedHat, which
230 is freely available at:
231 http://sources.redhat.com/cygwin/
232
4c1dce3 MAJ instructions installation
xleroy authored
233 This port runs under all versions of MS Windows supported by Cygwin.
82c273a MAJ et nettoyages
xleroy authored
234
235
236 INSTALLATION:
237
238 For various reasons, no binary distribution of this port is available.
239 You need to recompile from the source distribution.
240
241
242 RECOMPILATION FROM THE SOURCES:
243
244 Just follow the instructions for Unix machines given in the file INSTALL.
245
246
247 NOTES:
248
37d95e1 Le portage Mingw a besoin de Cygwin (et non Mingw+MSYS) pour compiler
xleroy authored
249 The libraries available in this port are "num", "str", "threads",
250 "unix" and "labltk". "graph" is not available yet.
82c273a MAJ et nettoyages
xleroy authored
251 The replay debugger is supported.
252
Something went wrong with that request. Please try again.