Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 112 lines (77 sloc) 4.129 kB
d06f82e Blabla sur la version Windows
xleroy authored
1 Release notes on the MS Windows port of Caml Special Light
2 ----------------------------------------------------------
3
4 REQUIREMENTS:
5
6 This port runs under Windows 95 and Windows NT on Intel-based machines.
7 Windows 3.1 and Windows for Workgroups are not supported. Windows NT
8 on non-Intel processors has not been tested.
9
10 The base bytecode system (cslc, csltop, csllex, cslyacc, ...) runs without
11 any additional tools.
12
13 Linking Caml bytecode with C code (cslc -custom) requires the
14 Microsoft Visual C++ compiler version 4.0.
15
16 The native-code compiler (cslopt) requires Visual C++ version 4.0
17 and the Microsoft assembler MASM version 5.
18
19 The cslmktop and cslcp commands are Bourne shell scripts.
20 They can be run with the Korn shell available at
21 ftp://ftp.winsite.com/pub/pc/winnt/misc/ntsh01.zip.
22
23
24 INSTALLATION:
25
26 The binary distribution consists of a .zip archive file. This .zip
27 contains long filenames and cannot therefore be unpacked with pkunzip
28 version 2. Use either Winzip (shareware) or the NT/95 version of unzip
29 (freeware):
30 ftp://ftp.winsite.com/pub/pc/winnt/misc/wznt56.exe
31 ftp://ftp.uu.net/pub/archiving/zip/WIN32/unz512xN.exe
32
33 Unzipping the distribution creates (among others) the following
34 directories and files:
35
36 camlsl\cslwin.exe The toplevel application
37 camlsl\cslwin.ini Its configuration file
38 camlsl\bin\ The command-line compilers and tools
39 camlsl\lib\ The standard library files
40
41 Installing the toplevel application:
42
43 Copy the file camlsl\cslwin.ini to the Windows system directory
44 (e.g. C:\windows). This file assumes that the standard library resides
45 in C:\camlsl\lib. If this is not the case, edit the file cslwin.ini
46 and change the line that says
47
48 CmdLine=cslrun C:\camlsl\lib\csltop -I C:\camlsl\lib
49 to
50 CmdLine=cslrun <caml_dir>\lib\csltop -I <caml_dir>\lib
51 e.g.
52 CmdLine=cslrun D:\lang\camlsl\lib\csltop -I D:\lang\camlsl\lib
53
54 Installing the command-line tools:
55
56 You must add the camlsl\bin subdirectory to the PATH variable, e.g.
57
58 set PATH=%PATH%;D:\lang\camlsl\bin
59
60 Running directly the tools (e.g. typing D:\lang\camlsl\bin\cslc)
61 will not work if the camlsl\bin directory is not in PATH, because cslc
62 and the other tools will be unable to find the Caml runtime system
63 cslrun.exe.
64
65 The command-line tools assume that the standard library resides in
66 C:\camlsl\lib. If you have unpacked it elsehwere, define the CAMLLIB
67 environment variable to point to the standard library directory, e.g.
68
69 set CAMLLIB=D:\lang\camlsl\lib
70
71
72 RECOMPILATION FROM THE SOURCES:
73
74 The command-line tools can be recompiled from the Unix source
75 distribution (csl-X.YZ.tar.gz), which also contains the files modified
76 for Windows.
77
78 In addition to Visual C++ 4.0 and MASM 5, you will also need a healthy
79 set of Unix / GNU utilities that understands long file names
80 (see e.g. ftp://ftp.cc.utexas.edu/microlib/nt/gnu/).
81
82 The bootstrap compilers provided in the Unix distribution (boot/cslc
83 and boot/csllex) must be replaced by those from the binary Windows
84 distribution (camlsl\bin\cslc.exe and camlsl\bin\csllex.exe).
85
86 The sources for the toplevel graphical user interface are not
87 publically available.
88
89
90 RANDOM NOTES:
91
92 * The VC++ compiler does a poor job on byterun/interp.c. Consequently,
93 the performance of bytecode programs is about half of that obtained
94 under Unix/GCC on similar hardware. GCC would give much better
95 performance, but none of the currently available ports of GCC for
96 Win32 is sufficiently complete, robust and stable to compile Caml
97 Special Light.
98
99 * The "num" and "str" libraries are available under Win32. The other
100 external libraries ("unix", "threads", "camltk4") make heavy use of
101 Unix system calls and require considerable work to run under Win32.
102
103
104 CREDITS:
105
106 The initial port of Caml Special Light to Windows NT was done by Kevin
107 Gallo at Microsoft Research, who kindly contributed its changes to the
108 Caml Special Light project.
109
110 The graphical user interface for the toplevel is due to Jean-Marie
111 Geffroy at INRIA Rocquencourt.
Something went wrong with that request. Please try again.