| 32 |
<box title="Download and installation" link="install"> |
<box title="Download and installation" link="install"> |
| 33 |
|
|
| 34 |
<p> |
<p> |
| 35 |
The build procedure for OCamlDuce is exactly the same as for OCaml: |
Currently, OCamlDuce |
|
<tt>configure, make world, make install</tt>. The names of the tools |
|
|
are unchanged: <tt>ocaml,ocamlc,ocamlopt</tt>. Currently, OCamlDuce |
|
| 36 |
is based on OCaml 3.08.4 and on a CVS snapshots |
is based on OCaml 3.08.4 and on a CVS snapshots |
| 37 |
of CDuce (between 0.3.92 and the head). |
of CDuce (between 0.3.92 and the head). |
| 38 |
</p> |
</p> |
| 39 |
|
|
| 40 |
<ul> |
<ul> |
| 41 |
<li><a |
<li><a |
| 42 |
href="http://pauillac.inria.fr/~frisch/ocamlcduce/download/ocamlduce-3.08.4.tar.gz">Compiler, |
href="http://pauillac.inria.fr/~frisch/ocamlcduce/download/ocamlduce-3.08.4pl1.tar.gz">Compiler, |
| 43 |
version 3.08.4</a></li> |
version 3.08.4, patch level 1</a></li> |
| 44 |
</ul> |
</ul> |
| 45 |
|
|
| 46 |
<p> |
<p> |
| 47 |
GODI users can upgrade an existing installation by adding this |
There are two different installation modes: |
| 48 |
|
</p> |
| 49 |
|
|
| 50 |
|
<ul> |
| 51 |
|
<li><b>Stand-alone mode</b>. OCamlDuce is used as a drop-in |
| 52 |
|
replacement for OCaml. The build procedure is unchanged: |
| 53 |
|
<tt>./configure && make world && make install</tt>. |
| 54 |
|
The tools are named <tt>ocaml, ocamlc, ocamlopt</tt>, ... |
| 55 |
|
The standard library is extended with the <tt>num</tt> library |
| 56 |
|
and the <tt>Ocamlduce</tt> module. |
| 57 |
|
</li> |
| 58 |
|
|
| 59 |
|
<li><b>Package mode</b>. OCamlDuce is installed on top of an existing |
| 60 |
|
OCaml installation (whose version number must match), without touching |
| 61 |
|
it. The build |
| 62 |
|
procedure is: <tt>./configure && make all && make opt |
| 63 |
|
&& make install</tt>. The <tt>configure</tt> script should be called with |
| 64 |
|
the same arguments as the ones used when you built OCaml. For instance, |
| 65 |
|
the <tt>LIBDIR</tt> argument is used to find OCaml standard library. |
| 66 |
|
The tools names are changed to <tt>ocamlduce, ocamlducec, |
| 67 |
|
ocamlduceopt</tt>, ... They use the existing standard library. |
| 68 |
|
In addition, a library <tt>ocamlduce.cma</tt> is built. |
| 69 |
|
It depends on the <tt>nums.cma</tt> library. The <tt>install</tt> |
| 70 |
|
target implements a <tt>Findlib</tt>-based installation. It registers |
| 71 |
|
a package named <tt>ocamlduce</tt> and it puts the tools |
| 72 |
|
in the package sub-directory (the <tt>BINDIR</tt> and <tt>LIBDIR</tt> |
| 73 |
|
arguments to <tt>configure</tt> are not used). The toplevel |
| 74 |
|
can be called by <tt>ocamlfind ocamlduce/ocamlduce</tt>. |
| 75 |
|
</li> |
| 76 |
|
</ul> |
| 77 |
|
|
| 78 |
|
<p> |
| 79 |
|
GODI users can choose any of these two modes. |
| 80 |
|
In order to upgrade an existing installation so as to use |
| 81 |
|
OCamlDuce in place of OCaml, they must add this |
| 82 |
line to their <tt>etc/godi.conf</tt> file: |
line to their <tt>etc/godi.conf</tt> file: |
| 83 |
</p> |
</p> |
| 84 |
<sample> |
<sample> |
| 85 |
GODI_BUILD_SITES += http://pauillac.inria.fr/~frisch/ocamlcduce/godi |
GODI_BUILD_SITES += http://pauillac.inria.fr/~frisch/ocamlcduce/godi |
| 86 |
</sample> |
</sample> |
| 87 |
<p> |
<p> |
| 88 |
and by forcing a recompilation of the <tt>godi-ocaml-src</tt> |
and force a recompilation of the <tt>godi-ocaml-src</tt> |
| 89 |
and <tt>godi-ocaml</tt> packages. <!--They should also build |
and <tt>godi-ocaml</tt> packages. The alternative is to install OCamlDuce |
| 90 |
the <tt>godi-xml-support</tt> library.--> |
as a GODI package over an existing installation. You don't need |
| 91 |
|
to touch the <tt>etc/godi.conf</tt> file. The package |
| 92 |
|
name is <tt>godi-ocamlduce</tt>. In order to use the new compilers |
| 93 |
|
and tools, you can make the environment variable |
| 94 |
|
<tt>OCAMLFIND_CONF</tt> point to the |
| 95 |
|
<tt>$GODI/etc/findlib-ocamlduce.conf</tt> file and then |
| 96 |
|
uses e.g. <tt>ocamlfind ocamlc -package ocamlduce</tt>. |
| 97 |
</p> |
</p> |
| 98 |
|
|
|
<!-- |
|
|
<p> |
|
|
Some simple examples can be found <a --> |
|
|
<!--href="http://pauillac.inria.fr/~frisch/ocamlcduce/tests/">here</a>.</p> |
|
|
--> |
|
|
|
|
| 99 |
</box> |
</box> |
| 100 |
|
|
| 101 |
<box title="Overview" link="overview"> |
<box title="Overview" link="overview"> |