Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

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