cgi-bin/viewcvs.cgi/INSTALL

Installation notes
==================

[In case of problems refer to the installation notes of each
package]

- ocaml 3.06
  (http://caml.inria.fr/ocaml/distrib.html)

  (
   We used at some point in CDuce development a patched
   version of the file nat_stubs.c in OCaml distribution;
   this patch should no longer be necessary.
   If someone gets the error "Abstract value", please report it to
   <Alain.Frisch@ens.fr>
   and try to replace the file in the OCaml source with the one that
   can be retrieved at http://www.cduce.org/nat_stubs.c)
   Follow normal instructions in the INSTALL file; typically:
   ./configure && make world && make opt && make install.
  )


- ocamlfind
  (http://www.ocaml-programming.de/packages/findlib-0.8.1.tar.gz)
   Usually it suffices to do:

   ./configure && make all && make opt && make install
  

- wlex
  (http://www.eleves.ens.fr/home/frisch/soft.html)
  specify in Makefile where is the source code (of the lex library)
  of OCaml [default is $HOME/ocaml-3.06/lex]: 
  OCAMLLEX_SRC = <source directory>

  then 
  make wlex && make install_wlex && make runtime && \ 
    make runtime.opt && make install_runtime 

  it is important to do make runtime.opt otherwise
  the web interface does not compile.

- pcre
  (http://www.pcre.org/)
  To install first do a simple:

  ./configure 

  For a custom configuration use options:

   --prefix=<prefix directory> --disable-shared
  
  then as usual make, make install


- pcre-ocaml
  (http://pcre-ocaml.sourceforge.net/)

  If pcre was installed in non standard place then in Makefile.conf:
  export STATIC = yes     #this may help but first try without
  export INCDIRS := <prefix_directory>/include
  export LIBDIRS := <prefix_directory>/lib

  After make all && make opt:
    cd lib
    cp ../META .
    ocamlfind install pcre META *.a *.cma *.cmxa *.cmi *.mli

- ocamlnet
  (http://ocamlnet.sourceforge.net/)
  cd in the src directory and then

   ./configure && make all && make opt && make install


- pxp (development version 1.1.93)
  (http://www.ocaml-programming.de/programming/pxp.html)

  ./configure && make all && make opt && make install


WEB SITE INSTALATION
====================

If you want to install CDuce site, with its online demo and tutorial
then you can study the Makefile (just do make web/files webiface.opt
and install the generated files by hand).

For the Apache server you may have to change its configuration file
httpd.conf. In particular you have to load php_mod and add to the
directives of the directory you installed the files the following:

<Directory "cduce_root">
    Options MultiViews 
# if .php is not in mime-types then also add:
    MultiviewsMatch Any
</Directory>
1	abate	104	Installation notes
2	abate	298	==================
3	abate	104
4	abate	298	[In case of problems refer to the installation notes of each
5			package]
6
7	abate	285	- ocaml 3.06
8	abate	298	(http://caml.inria.fr/ocaml/distrib.html)
9	abate	104
10	abate	323	(
11			We used at some point in CDuce development a patched
12			version of the file nat_stubs.c in OCaml distribution;
13			this patch should no longer be necessary.
14			If someone gets the error "Abstract value", please report it to
15			<Alain.Frisch@ens.fr>
16			and try to replace the file in the OCaml source with the one that
17			can be retrieved at http://www.cduce.org/nat_stubs.c)
18			Follow normal instructions in the INSTALL file; typically:
19			./configure && make world && make opt && make install.
20			)
21	abate	285
22	abate	298
23	abate	104	- ocamlfind
24	abate	298	(http://www.ocaml-programming.de/packages/findlib-0.8.1.tar.gz)
25	abate	323	Usually it suffices to do:
26	abate	104
27	abate	298	./configure && make all && make opt && make install
28
29
30	abate	323	- wlex
31			(http://www.eleves.ens.fr/home/frisch/soft.html)
32			specify in Makefile where is the source code (of the lex library)
33			of OCaml [default is $HOME/ocaml-3.06/lex]:
34			OCAMLLEX_SRC = <source directory>
35
36			then
37			make wlex && make install_wlex && make runtime && \
38			make runtime.opt && make install_runtime
39
40			it is important to do make runtime.opt otherwise
41			the web interface does not compile.
42
43	abate	104	- pcre
44	abate	298	(http://www.pcre.org/)
45			To install first do a simple:
46	abate	104
47	abate	298	./configure
48
49			For a custom configuration use options:
50
51			--prefix=<prefix directory> --disable-shared
52
53			then as usual make, make install
54
55
56	abate	104	- pcre-ocaml
57	abate	298	(http://pcre-ocaml.sourceforge.net/)
58	abate	104
59	abate	298	If pcre was installed in non standard place then in Makefile.conf:
60			export STATIC = yes #this may help but first try without
61			export INCDIRS := <prefix_directory>/include
62			export LIBDIRS := <prefix_directory>/lib
63
64			After make all && make opt:
65	abate	104	cd lib
66			cp ../META .
67			ocamlfind install pcre META .a .cma .cmxa .cmi *.mli
68
69			- ocamlnet
70	abate	298	(http://ocamlnet.sourceforge.net/)
71			cd in the src directory and then
72	abate	104
73	abate	298	./configure && make all && make opt && make install
74	abate	104
75	abate	298
76			- pxp (development version 1.1.93)
77			(http://www.ocaml-programming.de/programming/pxp.html)
78
79	abate	304	./configure && make all && make opt && make install
80	abate	298
81
82	abate	362
83			WEB SITE INSTALATION
84			====================
85
86			If you want to install CDuce site, with its online demo and tutorial
87			then you can study the Makefile (just do make web/files webiface.opt
88			and install the generated files by hand).
89
90			For the Apache server you may have to change its configuration file
91			httpd.conf. In particular you have to load php_mod and add to the
92			directives of the directory you installed the files the following:
93
94			<Directory "cduce_root">
95			Options MultiViews
96			# if .php is not in mime-types then also add:
97			MultiviewsMatch Any
98			</Directory>