Skip to content
Newer
Older
100644 244 lines (162 sloc) 8.08 KB
cf69c17 MAJ 3.01
xleroy authored
1 Release notes on the MS Windows ports of Objective Caml
2 -------------------------------------------------------
3
1131ee4 MAJ portage MinGW
xleroy authored
4 Starting with OCaml 3.05, there are now no less than three ports of
5 Objective Caml for MS Windows available:
6 - a native Win32 port, built with the Microsoft development tools (non-free);
7 - a native Win32 port, built with the MinGW development tools (free);
cf69c17 MAJ 3.01
xleroy authored
8 - a port consisting of the Unix sources compiled under the Cygwin
1131ee4 MAJ portage MinGW
xleroy authored
9 Unix-like environment for Windows (free).
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
1131ee4 MAJ portage MinGW
xleroy authored
13 Native MS Native MinGW Cygwin
14 Third-party software required
15 - for base bytecode system none none none
82c273a MAJ et nettoyages
xleroy authored
16 - for ocamlc -custom MSVC MinGW or Cygwin Cygwin
17 - for native-code generation MSVC+MASM MinGW or Cygwin Cygwin
cf69c17 MAJ 3.01
xleroy authored
18
1131ee4 MAJ portage MinGW
xleroy authored
19 Speed of bytecode interpreter 70% 100% 100%
20
21 Replay debugger no no yes
22
23 The Unix library partial partial full
24
25 The Threads library yes yes no
26
27 The Graphics library yes yes no
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
33 that is compatible with the GPL. Executables generated by MS VC or by
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
cf69c17 MAJ 3.01
xleroy authored
45 This port runs under MS Windows 95, 98, ME, NT and 2000 on Intel IA32
46 machines. Windows 3.1 and Windows for Workgroups are not
47 supported. Windows NT on non-Intel processors has not been tested.
d06f82e Blabla sur la version Windows
xleroy authored
48
11d8fff Renommage en Objective Caml
xleroy authored
49 The base bytecode system (ocamlc, ocaml, ocamllex, ocamlyacc, ...)
50 runs without any additional tools.
d06f82e Blabla sur la version Windows
xleroy authored
51
9eaedc5 Chargement dynamique de primitives C
xleroy authored
52 Statically linking Caml bytecode with C code (ocamlc -custom) requires the
53 Microsoft Visual C++ compiler version 6. Dynamic loading of DLLs is
54 supported out of the box, without additional software.
d06f82e Blabla sur la version Windows
xleroy authored
55
ca8d02d Mentionner que MASM est gratuit
xleroy authored
56 The native-code compiler (ocamlopt) requires Visual C++ version 6
57 and the Microsoft assembler MASM version 6.11 or later.
58 MASM can be downloaded for free from Microsoft's Web site;
82c273a MAJ et nettoyages
xleroy authored
59 for directions, see
60 http://www.easystreet.com/~jkirwan/pctools.html
61 or http://www2.dgsys.com/~raymoon/faq/masm.html
62 or the comp.lang.asm.x86 FAQ.
d06f82e Blabla sur la version Windows
xleroy authored
63
551e55a MAJ pour version 3.02
xleroy authored
64 The LablTk GUI requires Tcl/Tk 8.3. Windows binaries are
82c273a MAJ et nettoyages
xleroy authored
65 available from http://prdownloads.sourceforge.net/tcl/tcl832.exe.
f577670 configure, INSTALL: option -with-pthread
xleroy authored
66
d06f82e Blabla sur la version Windows
xleroy authored
67
68 INSTALLATION:
69
1b438f1 MAJ
xleroy authored
70 The binary distribution is a self-installing executable archive.
71 Just run it and it should install OCaml automatically.
d06f82e Blabla sur la version Windows
xleroy authored
72
73 Installing the command-line tools:
74
1b438f1 MAJ
xleroy authored
75 You must add the "bin" subdirectory of the OCaml installation directory
76 to the PATH variable, e.g.
d06f82e Blabla sur la version Windows
xleroy authored
77
11d8fff Renommage en Objective Caml
xleroy authored
78 set PATH=%PATH%;D:\lang\ocaml\bin
d06f82e Blabla sur la version Windows
xleroy authored
79
11d8fff Renommage en Objective Caml
xleroy authored
80 Running directly the tools (e.g. typing D:\lang\ocaml\bin\ocamlc)
1b438f1 MAJ
xleroy authored
81 will not work if the "bin" subdirectory is not in PATH, because ocamlc
d06f82e Blabla sur la version Windows
xleroy authored
82 and the other tools will be unable to find the Caml runtime system
11d8fff Renommage en Objective Caml
xleroy authored
83 ocamlrun.exe.
d06f82e Blabla sur la version Windows
xleroy authored
84
551e55a MAJ pour version 3.02
xleroy authored
85 To use the LablTK GUI, the directory where the libraries tk83.lib
86 and tcl83.lib were installed (by the Tcl/Tk installer)
87 must be added to the library search path in the LIB environment variable.
88 E.g. if Tcl/Tk was installed in C:\tcl, add "C:\tcl\lib" to the LIB
89 environment variable.
90
cf69c17 MAJ 3.01
xleroy authored
91
d06f82e Blabla sur la version Windows
xleroy authored
92 RECOMPILATION FROM THE SOURCES:
93
94 The command-line tools can be recompiled from the Unix source
11d8fff Renommage en Objective Caml
xleroy authored
95 distribution (ocaml-X.YZ.tar.gz), which also contains the files modified
d06f82e Blabla sur la version Windows
xleroy authored
96 for Windows.
97
9eaedc5 Chargement dynamique de primitives C
xleroy authored
98 You will need the following software components to perform the recompilation:
1131ee4 MAJ portage MinGW
xleroy authored
99 - Windows NT, 2000, or XP (we advise against compiling under Windows 95/98/ME)
9eaedc5 Chargement dynamique de primitives C
xleroy authored
100 - Visual C++ version 6
101 - MASM version 6.11 (see above)
102 - The CygWin port of GNU tools, available from
103 http://sourceware.cygnus.com/cygwin/
104 - TCL/TK version 8.3 (for the LablTK GUI) (see above).
d06f82e Blabla sur la version Windows
xleroy authored
105
1131ee4 MAJ portage MinGW
xleroy authored
106 To recompile, start a Cygwin shell and change to the top-level
107 directory of the OCaml distribution. Then, do
108
109 cp config/m-nt.h config/m.h
110 cp config/s-nt.h config/s.h
111 cp config/Makefile.msvc config/Makefile
f46ea68 MAJ. Description de la recompilation a partir des sources
xleroy authored
112
82c273a MAJ et nettoyages
xleroy authored
113 Then, edit config/Makefile as needed, following the comments in this file.
114 Normally, the only variables that need to be changed are
115 PREFIX where to install everything
116 TK_ROOT where TCL/TK was installed
d06f82e Blabla sur la version Windows
xleroy authored
117
1131ee4 MAJ portage MinGW
xleroy authored
118 Finally, use "make -f Makefile.nt" to build the system, e.g.
119
120 make -f Makefile.nt world
121 make -f Makefile.nt bootstrap
122 make -f Makefile.nt opt
123 make -f Makefile.nt install
124
125
126 NOTES:
d06f82e Blabla sur la version Windows
xleroy authored
127
82c273a MAJ et nettoyages
xleroy authored
128 * The VC++ compiler does not implement "computed gotos", and therefore
129 doesn't generate very efficient code for byterun/interp.c. Consequently,
551e55a MAJ pour version 3.02
xleroy authored
130 the performance of bytecode programs is about 2/3 of that obtained under
1131ee4 MAJ portage MinGW
xleroy authored
131 Unix/GCC or Cygwin or Mingw on similar hardware.
90170a2 MAJ.
xleroy authored
132
9eb33db MAJ
xleroy authored
133 * Libraries available in this port: "num", "str", "threads", "graphics",
cf69c17 MAJ 3.01
xleroy authored
134 "labltk", and large parts of "unix".
d06f82e Blabla sur la version Windows
xleroy authored
135
1131ee4 MAJ portage MinGW
xleroy authored
136 * The replay debugger is not supported.
d06f82e Blabla sur la version Windows
xleroy authored
137
138 CREDITS:
139
11d8fff Renommage en Objective Caml
xleroy authored
140 The initial port of Caml Special Light (the ancestor of Objective Caml)
141 to Windows NT was done by Kevin Gallo at Microsoft Research, who
142 kindly contributed his changes to the Caml project.
d06f82e Blabla sur la version Windows
xleroy authored
143
9eb33db MAJ
xleroy authored
144 The graphical user interface for the toplevel is due to Jacob Navia.
1131ee4 MAJ portage MinGW
xleroy authored
145
146 ------------------------------------------------------------------------------
147
148 The native Win32 port built with Mingw
149 --------------------------------------
150
151 REQUIREMENTS:
152
153 This port runs under MS Windows 95, 98, ME, NT and 2000 on Intel IA32
154 machines.
155
156 The base bytecode system (ocamlc, ocaml, ocamllex, ocamlyacc, ...)
157 runs without any additional tools.
158
159 The native-code compiler (ocamlopt), as well as static linking of
82c273a MAJ et nettoyages
xleroy authored
160 Caml bytecode with C code (ocamlc -custom), require either the MinGW
1131ee4 MAJ portage MinGW
xleroy authored
161 development tools, which is free software available at
162 http://www.mingw.org/
82c273a MAJ et nettoyages
xleroy authored
163 or the Cygwin development toos, available at
164 http://sources.redhat.com/cygwin/
1131ee4 MAJ portage MinGW
xleroy authored
165
82c273a MAJ et nettoyages
xleroy authored
166 The LablTk GUI requires Tcl/Tk 8.3. Windows binaries are
167 available from http://prdownloads.sourceforge.net/tcl/tcl832.exe.
1131ee4 MAJ portage MinGW
xleroy authored
168
169
170 INSTALLATION:
171
82c273a MAJ et nettoyages
xleroy authored
172 There is no binary distribution yet, so please follow the compilation
173 instructions below.
1131ee4 MAJ portage MinGW
xleroy authored
174
175
176 RECOMPILATION FROM THE SOURCES:
177
178 You will need the following software components to perform the recompilation:
179 - Windows NT, 2000, or XP (we advise against compiling under Windows 95/98/ME)
180 - Cygwin: http://sourceware.cygnus.com/cygwin/
82c273a MAJ et nettoyages
xleroy authored
181 - TCL/TK version 8.3 (see above).
1131ee4 MAJ portage MinGW
xleroy authored
182
183 Start a Cygwin shell and unpack the source distribution
184 (ocaml-X.YZ.tar.gz) with "tar xzf". Change to the top-level
185 directory of the OCaml distribution. Then, do
186
187 cp config/m-nt.h config/m.h
188 cp config/s-nt.h config/s.h
189 cp config/Makefile.mingw config/Makefile
190
82c273a MAJ et nettoyages
xleroy authored
191 Then, edit config/Makefile as needed, following the comments in this file.
192 Normally, the only variables that need to be changed are
193 PREFIX where to install everything
194 TK_ROOT where TCL/TK was installed
1131ee4 MAJ portage MinGW
xleroy authored
195
196 Finally, use "make -f Makefile.nt" to build the system, e.g.
197
198 make -f Makefile.nt world
199 make -f Makefile.nt bootstrap
200 make -f Makefile.nt opt
201 make -f Makefile.nt opt.opt
82c273a MAJ et nettoyages
xleroy authored
202 make -f Makefile.nt install
1131ee4 MAJ portage MinGW
xleroy authored
203
204
205 NOTES:
206
207 * Libraries available in this port: "num", "str", "threads", "graphics",
208 "labltk", and large parts of "unix".
209
210 * The replay debugger is not supported.
82c273a MAJ et nettoyages
xleroy authored
211
212 ------------------------------------------------------------------------------
213
214 The Cygwin port of Objective Caml
215 ---------------------------------
216
217 REQUIREMENTS:
218
219 This port requires the Cygwin environment from Cygnus/RedHat, which
220 is freely available at:
221 http://sources.redhat.com/cygwin/
222
223 This port runs under all versions of MS Windows supported by Cygwin,
224 i.e. Windows 95, 98, ME, NT and 2000 on Intel IA32 machines.
225
226
227 INSTALLATION:
228
229 For various reasons, no binary distribution of this port is available.
230 You need to recompile from the source distribution.
231
232
233 RECOMPILATION FROM THE SOURCES:
234
235 Just follow the instructions for Unix machines given in the file INSTALL.
236
237
238 NOTES:
239
240 The libraries available in this port are "num", "str", "unix" and "labltk".
241 "graph" and "threads" are not available yet.
242 The replay debugger is supported.
243
Something went wrong with that request. Please try again.