cduce/trunk/INSTALL.WIN32

                 Installation Notes for Windows NT/2000/XP
                 =========================================


CDuce can be executed on Microsoft Windows by using the
RedHat/Cygnus environment Cygwin freely available at

http://www.cygwin.com/

The executable needs the cygwin1.dll that is distributed 
under GPL license. This is not compatible with the CDuce license.
For this reason we do not provide binaries but give here detailed 
instructions about how to compile CDuce sources under Cygwin/Windows.


------------------------------------------------------------------------------
Prerequisites
------------------------------------------------------------------------------

Before compiling CDuce on Windows, you need to install the
following releases of the these packages (newer releases may
work):


cygwin
  http://www.cygwin.com
ocaml 3.10.0
  http://caml.inria.fr/ocaml/distrib.html
findlib 1.2.1   
  http://www.ocaml-programming.de/packages
ulex 1.0
  http://www.cduce.org/download.html
pcre-ocaml
  http://ocaml.info/home/ocaml_sources.html
ocamlnet 2.2.9
  http://www.ocaml-programming.de/packages
pxp 1.2.0
  http://www.ocaml-programming.de/packages/documentation/pxp/index_dev.html


Installation notes (you are advised to follow this order):


1) Download and execute cygwin setup.exe.
   - Choose Internet installation
   - Choose a root directory whose path has no blanks in it
   - Choose as Local Package Directory <your root>/usr/src (optional)
   - Choose the mirror closest to you
   - When asked to select the packages to install add to the default
     choices the following packages:
       Devel/
         autoconf*
         automake*
         binutils
         gcc*
         make
         patchutils
       Interpreters/
         m4
       Lib/
         libpcre
         pcre
         pcre-devel
     you may also find useful to install the following packages
       Editors/
         emacs or vim (no trolls)
       Net/
         ncftp
         openssh
       Devel/
         binutils
         subversion
       Utils/
         bc
         bzip2
         diff
         diffutils
         file
         patch
         patchutils
     then proceed with installation


2) Download (we suggest in /usr/src) and install Ocaml
   [For the impatient:
     ./configure
     make world.opt
     make install]


3) Download (guess where) and install findlib.

   A plain 

     ./configure
     make all
     make opt
     make install

   should work, but it is worth checking that the paths that come
   out looking right in Makefile.config after ./configure.
   Otherwise correct paths in findlib.conf and re-run configure.
   E.g.: ./configure -bindir /usr/local/bin -mandir /usr/local/man


4) Download and install ulex 
   The ocaml 3.10.0 version of ulex on cygwin requires to add the
   "-classic-display" option to ocamlbuild in the Makefile.
     make all
     make all.opt
     make install


5) Download and install pcre-ocaml. 
   If you get an error regarding dynmaically loaded library try to
   add STATIC=yes in Makefile.conf

     make
     make install
   

6) Download and install ocamlnet

   ./configure
   make all
   make opt
   make install


7) PXP:
   CDuce requires a development version >= 1.1.93.

   ./configure -without-wlex -without-wlex-compat -lexlist utf8,iso88591 -without-pp
   (there is a problem with the preprocessor in cygwin, so you
   get an error if you don't add the -without-pp)

   make all
   make opt
   make install


Now you can compile CDuce sources as indicated in the INSTALL file 
namely 

  
------------------------------------------------------------------------------
Compilation, installation
------------------------------------------------------------------------------

See the INSTALL file.


1	abate	406	Installation Notes for Windows NT/2000/XP
2	abate	404	=========================================
3
4
5			CDuce can be executed on Microsoft Windows by using the
6			RedHat/Cygnus environment Cygwin freely available at
7
8	abate	446	http://www.cygwin.com/
9	abate	404
10	abate	406	The executable needs the cygwin1.dll that is distributed
11			under GPL license. This is not compatible with the CDuce license.
12			For this reason we do not provide binaries but give here detailed
13	abate	404	instructions about how to compile CDuce sources under Cygwin/Windows.
14
15
16			------------------------------------------------------------------------------
17			Prerequisites
18			------------------------------------------------------------------------------
19
20	karoline	3934	Before compiling CDuce on Windows, you need to install the
21			following releases of the these packages (newer releases may
22			work):
23	abate	404
24
25			cygwin
26	abate	415	http://www.cygwin.com
27	karoline	3934	ocaml 3.10.0
28	abate	404	http://caml.inria.fr/ocaml/distrib.html
29	karoline	3934	findlib 1.2.1
30	abate	404	http://www.ocaml-programming.de/packages
31	karoline	3934	ulex 1.0
32			http://www.cduce.org/download.html
33			pcre-ocaml
34			http://ocaml.info/home/ocaml_sources.html
35			ocamlnet 2.2.9
36			http://www.ocaml-programming.de/packages
37			pxp 1.2.0
38	abate	404	http://www.ocaml-programming.de/packages/documentation/pxp/index_dev.html
39
40
41			Installation notes (you are advised to follow this order):
42
43	karoline	3934
44	abate	404	1) Download and execute cygwin setup.exe.
45			- Choose Internet installation
46			- Choose a root directory whose path has no blanks in it
47			- Choose as Local Package Directory <your root>/usr/src (optional)
48			- Choose the mirror closest to you
49			- When asked to select the packages to install add to the default
50			choices the following packages:
51			Devel/
52			autoconf*
53			automake*
54			binutils
55			gcc*
56			make
57	abate	804	patchutils
58	karoline	3934	Interpreters/
59			m4
60	abate	404	Lib/
61	abate	767	libpcre
62	karoline	3934	pcre
63			pcre-devel
64	abate	404	you may also find useful to install the following packages
65			Editors/
66			emacs or vim (no trolls)
67			Net/
68	karoline	3934	ncftp
69	abate	404	openssh
70			Devel/
71	karoline	3934	binutils
72			subversion
73	abate	404	Utils/
74	karoline	3934	bc
75			bzip2
76	abate	404	diff
77	karoline	3934	diffutils
78			file
79	abate	404	patch
80	karoline	3934	patchutils
81	abate	406	then proceed with installation
82	abate	404
83
84			2) Download (we suggest in /usr/src) and install Ocaml
85	karoline	3934	[For the impatient:
86			./configure
87			make world.opt
88			make install]
89	abate	404
90
91	karoline	3934	3) Download (guess where) and install findlib.
92	abate	404
93	karoline	3934	A plain
94	abate	404
95	karoline	3934	./configure
96			make all
97			make opt
98			make install
99
100			should work, but it is worth checking that the paths that come
101			out looking right in Makefile.config after ./configure.
102			Otherwise correct paths in findlib.conf and re-run configure.
103			E.g.: ./configure -bindir /usr/local/bin -mandir /usr/local/man
104
105
106	abate	767	4) Download and install ulex
107	abate	3928	The ocaml 3.10.0 version of ulex on cygwin requires to add the
108	karoline	3934	"-classic-display" option to ocamlbuild in the Makefile.
109			make all
110			make all.opt
111			make install
112	abate	404
113
114	abate	767	5) Download and install pcre-ocaml.
115	abate	3928	If you get an error regarding dynmaically loaded library try to
116			add STATIC=yes in Makefile.conf
117	abate	404
118	karoline	3934	make
119			make install
120	abate	404
121	karoline	3934
122	abate	404	6) Download and install ocamlnet
123
124	karoline	3934	./configure
125			make all
126			make opt
127			make install
128	abate	404
129	karoline	3934
130	abate	404	7) PXP:
131			CDuce requires a development version >= 1.1.93.
132
133	karoline	3934	./configure -without-wlex -without-wlex-compat -lexlist utf8,iso88591 -without-pp
134			(there is a problem with the preprocessor in cygwin, so you
135			get an error if you don't add the -without-pp)
136	abate	404
137	karoline	3934	make all
138			make opt
139			make install
140
141
142	abate	404	Now you can compile CDuce sources as indicated in the INSTALL file
143			namely
144
145
146			------------------------------------------------------------------------------
147	abate	642	Compilation, installation
148	abate	404	------------------------------------------------------------------------------
149
150	abate	642	See the INSTALL file.
151	abate	767
152
153
154