| 1 |
Installation Notes for CDuce
|
| 2 |
============================
|
| 3 |
|
| 4 |
CDuce is written in the OCaml programming language. It has been
|
| 5 |
sucessfully compiled under Intel Linux, SunOS 5.7, Window XP
|
| 6 |
and FreeBSD 4.7.
|
| 7 |
|
| 8 |
------------------------------------------------------------------------------
|
| 9 |
Prerequisites
|
| 10 |
------------------------------------------------------------------------------
|
| 11 |
|
| 12 |
Before compiling CDuce, you need to install recent releases of the
|
| 13 |
following packages:
|
| 14 |
|
| 15 |
ocaml
|
| 16 |
http://caml.inria.fr/ocaml/distrib.html
|
| 17 |
findlib
|
| 18 |
http://www.ocaml-programming.de/packages
|
| 19 |
wlex
|
| 20 |
http://www.eleves.ens.fr/home/frisch/soft.html#wlex
|
| 21 |
pcre-ocaml
|
| 22 |
http://www.ai.univie.ac.at/~markus/home/ocaml_sources.html
|
| 23 |
ocamlnet
|
| 24 |
http://ocamlnet.sourceforge.net/
|
| 25 |
pxp
|
| 26 |
http://www.ocaml-programming.de/packages/documentation/pxp/index_dev.html
|
| 27 |
|
| 28 |
|
| 29 |
Important notes:
|
| 30 |
|
| 31 |
- the packages above must be installed in the order we used above. In
|
| 32 |
particular wlex _must_ be installed before pcre-ocaml and pxp.
|
| 33 |
|
| 34 |
- wlex: you only need to build and install the runtime support library
|
| 35 |
(not the wlex tool itself):
|
| 36 |
|
| 37 |
make runtime.all & make install_runtime
|
| 38 |
|
| 39 |
- pcre-ocaml: you may also need to install the PCRE library
|
| 40 |
from http://www.pcre.org/
|
| 41 |
|
| 42 |
./configure --prefix=<prefix directory> --disable-shared
|
| 43 |
|
| 44 |
If pcre was installed in non standard place then in Makefile.conf:
|
| 45 |
export STATIC = yes #this may help but first try without
|
| 46 |
export INCDIRS := <prefix_directory>/include
|
| 47 |
export LIBDIRS := <prefix_directory>/lib
|
| 48 |
|
| 49 |
After make all && make opt:
|
| 50 |
cd lib
|
| 51 |
cp ../META .
|
| 52 |
ocamlfind install pcre META *.a *.cma *.cmxa *.cmi *.mli
|
| 53 |
|
| 54 |
- PXP:
|
| 55 |
CDuce requires a development version >= 1.1.93.
|
| 56 |
|
| 57 |
|
| 58 |
Efficiency issues:
|
| 59 |
|
| 60 |
- OCamlnet: if you plan to load XML file with encodings other than
|
| 61 |
UTF-8, it is advised to use the CVS version of OCamlnet:
|
| 62 |
http://sourceforge.net/cvs/?group_id=19774
|
| 63 |
Indeed, the netconversion module in the lastest release (0.95) was
|
| 64 |
very slow, and it has been rewritten since then.
|
| 65 |
|
| 66 |
------------------------------------------------------------------------------
|
| 67 |
Compilation
|
| 68 |
------------------------------------------------------------------------------
|
| 69 |
|
| 70 |
You need a GNU Make (or equivalent) to use the Makefile from the
|
| 71 |
distribution. It defines the following goals:
|
| 72 |
|
| 73 |
- make cduce
|
| 74 |
compiles the CDuce command line interpreter
|
| 75 |
|
| 76 |
- make dtd2cduce
|
| 77 |
compiles the dtd2cduce tools (converts DTD to CDuce types)
|
| 78 |
|
| 79 |
- make webiface
|
| 80 |
compiles the CDuce web interface interpreter (to be used as a CGI script)
|
| 81 |
|
| 82 |
- make local_website
|
| 83 |
compiles in the web/www/ subdirectory the HTML files of CDuce website
|
| 84 |
(including the tutorial)
|
| 85 |
|
| 86 |
- make all
|
| 87 |
equivalent to (make cduce; make dtd2cduce; make local_website)
|
| 88 |
|
| 89 |
|
| 90 |
Makefile accepts the following options, which can take the values
|
| 91 |
true or false.
|
| 92 |
|
| 93 |
NATIVE=true : use the OCaml native code compiler (ocamlopt) to build CDuce
|
| 94 |
NATIVE=false : use the OCaml bytecode compiler (ocamlc)
|
| 95 |
default: true (the native code version is much faster)
|
| 96 |
|
| 97 |
PXP_WLEX=true : use wlex for parsing UTF-8 XML files
|
| 98 |
PXP_WLEX=false: use ocamllex for parsing UTF-8 XML files
|
| 99 |
default: false (ocamllex is faster; wlex is more compact)
|
| 100 |
|
| 101 |
E.g.:
|
| 102 |
make cduce NATIVE=false |
Parent Directory
| 
Revision Log