Skip to content
Newer
Older
100644 169 lines (114 sloc) 6.14 KB
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
1 Release notes on the MS Windows ports of Objective Caml
2 -------------------------------------------------------
3
4 Starting with OCaml 3.01, there are now two ports of Objective Caml
5 for MS Windows available:
6 - a native Win32 port, built with the Microsoft development tools;
7 - a port consisting of the Unix sources compiled under the Cygwin
8 Unix-like environment for Windows.
9
10 The Cygwin port requires only free software, runs faster in bytecode
11 mode, and provides a more thorough emulation of the Unix library.
12 It currently lacks the threads library and the ability to interface
13 with COM components via CamlIDL. No graphical user interface to the
14 OCaml toplevel is provided.
15
16 The native Win32 port has threads and COM support, but is slower in
17 bytecode, does not implement some of the functionality of the Unix library,
18 and requires MS Visual C++ version 6 for compilation in -custom mode
19 and in native-code mode. A simple graphical user interface to the
20 OCaml toplevel is provided.
21
22 The remainder of this document provides more information on both ports.
23
24 ------------------------------------------------------------------------------
25
26 The Cygwin port of Objective Caml
27 ---------------------------------
28
29 REQUIREMENTS:
30
31 This port requires the Cygwin environment from Cygnus/RedHat, which
32 is freely available at:
33 http://sources.redhat.com/cygwin/
34 Version 1.1 or the upcoming version 1.2 are recommended.
35
36 This port runs under all versions of MS Windows supported by Cygwin,
37 i.e. Windows 95, 98, ME, NT and 2000 on Intel IA32 machines.
38
39
40 INSTALLATION:
41
42 The binary distribution is a .tar.gz archive that unpacks in
43 usr/local/bin and usr/local/lib/ocaml/. To install, just open
44 a "bash" windows and type:
45 cd /
46 tar xvzf /full/path/to/ocaml-X.XX-cygwin.tar.gz
47
48 Make sure that /usr/local/bin is in the PATH environment variable.
49
50
51 RECOMPILATION FROM THE SOURCES:
52
53 Just follow the instructions for Unix machines given in the file INSTALL.
54
55
56 NOTES:
57
58 The libraries available in this port are "num", "str", "unix" and "labltk".
59 "graph" and "threads" are not available yet.
60
61
62 ------------------------------------------------------------------------------
63
64 The native Win32 port of Objective Caml
65 ---------------------------------------
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
66
67 REQUIREMENTS:
68
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
69 This port runs under MS Windows 95, 98, ME, NT and 2000 on Intel IA32
70 machines. Windows 3.1 and Windows for Workgroups are not
71 supported. Windows NT on non-Intel processors has not been tested.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
72
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
73 The base bytecode system (ocamlc, ocaml, ocamllex, ocamlyacc, ...)
74 runs without any additional tools.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
75
9eaedc5 Chargement dynamique de primitives C
xleroy authored Aug 28, 2001
76 Statically linking Caml bytecode with C code (ocamlc -custom) requires the
77 Microsoft Visual C++ compiler version 6. Dynamic loading of DLLs is
78 supported out of the box, without additional software.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
79
ca8d02d Mentionner que MASM est gratuit
xleroy authored Nov 8, 1999
80 The native-code compiler (ocamlopt) requires Visual C++ version 6
81 and the Microsoft assembler MASM version 6.11 or later.
82 MASM can be downloaded for free from Microsoft's Web site;
83 see the comp.lang.asm.x86 FAQ for directions, or
84 http://www.cs.uu.nl/wais/html/na-dir/assembly-language/x86/microsoft.html
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
85
551e55a MAJ pour version 3.02
xleroy authored Jul 27, 2001
86 The LablTk GUI requires Tcl/Tk 8.3. Windows binaries are
87 available from ftp://ftp.scriptics.com/pub/tcl/tcl8_3/.
f577670 configure, INSTALL: option -with-pthread
xleroy authored Oct 24, 1997
88
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
89
90 INSTALLATION:
91
1b438f1 MAJ
xleroy authored Nov 26, 1999
92 The binary distribution is a self-installing executable archive.
93 Just run it and it should install OCaml automatically.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
94
95 Installing the command-line tools:
96
1b438f1 MAJ
xleroy authored Nov 26, 1999
97 You must add the "bin" subdirectory of the OCaml installation directory
98 to the PATH variable, e.g.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
99
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
100 set PATH=%PATH%;D:\lang\ocaml\bin
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
101
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
102 Running directly the tools (e.g. typing D:\lang\ocaml\bin\ocamlc)
1b438f1 MAJ
xleroy authored Nov 26, 1999
103 will not work if the "bin" subdirectory is not in PATH, because ocamlc
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
104 and the other tools will be unable to find the Caml runtime system
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
105 ocamlrun.exe.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
106
107 The command-line tools assume that the standard library resides in
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
108 C:\ocaml\lib. If you have unpacked it elsehwere, define the CAMLLIB
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
109 environment variable to point to the standard library directory, e.g.
110
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
111 set CAMLLIB=D:\lang\ocaml\lib
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
112
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
113 For Windows 95, 98 and ME, the OCaml installer is able to perform the
1b438f1 MAJ
xleroy authored Nov 26, 1999
114 corresponding modifications to AUTOEXEC.BAT (define CAMLLIB and
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
115 append to the PATH variable). For Windows NT and 2000, you'll have to
1b438f1 MAJ
xleroy authored Nov 26, 1999
116 edit the environment variables yourself.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
117
551e55a MAJ pour version 3.02
xleroy authored Jul 27, 2001
118 To use the LablTK GUI, the directory where the libraries tk83.lib
119 and tcl83.lib were installed (by the Tcl/Tk installer)
120 must be added to the library search path in the LIB environment variable.
121 E.g. if Tcl/Tk was installed in C:\tcl, add "C:\tcl\lib" to the LIB
122 environment variable.
123
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
124
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
125 RECOMPILATION FROM THE SOURCES:
126
127 The command-line tools can be recompiled from the Unix source
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
128 distribution (ocaml-X.YZ.tar.gz), which also contains the files modified
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
129 for Windows.
130
9eaedc5 Chargement dynamique de primitives C
xleroy authored Aug 28, 2001
131 You will need the following software components to perform the recompilation:
132 - Windows NT or 2000 (the Makefiles do not work under Windows 95, 98, ME
133 due to differences between NT and 9x command-line interpreters);
134 - Visual C++ version 6
135 - MASM version 6.11 (see above)
136 - The CygWin port of GNU tools, available from
137 http://sourceware.cygnus.com/cygwin/
138 - TCL/TK version 8.3 (for the LablTK GUI) (see above).
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
139
f46ea68 MAJ. Description de la recompilation a partir des sources
xleroy authored Oct 19, 1999
140 To recompile, first copy manually the files config/m-nt.h and config/s-nt.h
141 to config/m.h and config/s.h. Edit config/Makefile.nt as needed.
142 Then, use "nmake -f Makefile.nt" to build the system, e.g.
143
144 nmake -f Makefile.nt world
145 nmake -f Makefile.nt bootstrap
146 nmake -f Makefile.nt opt
147
370efa2 MAJ pour le debugger et autres
xleroy authored Feb 23, 1997
148 The sources for the toplevel graphical user interface are not currently
149 available to the general public. Contact us if you think you need them.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
150
151
152 RANDOM NOTES:
153
154 * The VC++ compiler does a poor job on byterun/interp.c. Consequently,
551e55a MAJ pour version 3.02
xleroy authored Jul 27, 2001
155 the performance of bytecode programs is about 2/3 of that obtained under
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
156 Unix/GCC or Cygwin on similar hardware.
90170a2 MAJ.
xleroy authored Oct 25, 1996
157
9eb33db MAJ
xleroy authored Dec 3, 2001
158 * Libraries available in this port: "num", "str", "threads", "graphics",
cf69c17 MAJ 3.01
xleroy authored Feb 6, 2001
159 "labltk", and large parts of "unix".
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
160
161
162 CREDITS:
163
11d8fff Renommage en Objective Caml
xleroy authored Apr 30, 1996
164 The initial port of Caml Special Light (the ancestor of Objective Caml)
165 to Windows NT was done by Kevin Gallo at Microsoft Research, who
166 kindly contributed his changes to the Caml project.
d06f82e Blabla sur la version Windows
xleroy authored Feb 25, 1996
167
9eb33db MAJ
xleroy authored Dec 3, 2001
168 The graphical user interface for the toplevel is due to Jacob Navia.
Something went wrong with that request. Please try again.