[r2003-08-15 18:40:32 by cvscast] Improve english. Peculiar does not mean what we mean.

Original author: cvscast
Date: 2003-08-15 18:40:32+00:00

CHANGES

 0.1.1
-  * Various bug fixes
+  * Various bug fixes  (expat might now work)
   * Sequencing operator   e1;e2  (equivalent to: let [] = e1 in e2)
   * Encoded references
   

INSTALL

@@ -80,9 +80,10 @@ distribution. It defines the following goals:
 - make all
   equivalent to (make cduce dtd2cduce webiface webpages)
 
+- make install
+  (see PREFIX below)
 
-Makefile accepts the following options, which can take the values
-true or false.
+Makefile accepts the following options.
 
 NATIVE=true   : use the OCaml native code compiler (ocamlopt) to build CDuce
 NATIVE=false  : use the OCaml bytecode compiler (ocamlc)
@@ -92,6 +93,9 @@ PXP_WLEX=true : use wlex for parsing UTF-8 XML files
 PXP_WLEX=false: use ocamllex for parsing UTF-8 XML files
   default: false (ocamllex is faster; wlex is more compact)
 
+PREFIX=/usr/local by default: where to install CDuce files (see
+ Makefile.conf)
+
 E.g.:
   make cduce NATIVE=false
 
@@ -122,4 +126,5 @@ You can still use PXP by providing the --pxp switch on the command
 line.
 
 Note: the current wrapper for expat does not support inclusion
-of external entities. Moreover I encounter random segfaults...
+of external entities. Moreover, the error messages in case of
+ill-formed XML are less informative than PXP's.

INSTALL.WIN32

@@ -112,51 +112,7 @@ namely
 
   
 ------------------------------------------------------------------------------
-Compilation
+Compilation, installation
 ------------------------------------------------------------------------------
 
-You need a GNU Make (or equivalent) to use the Makefile from the
-distribution. It defines the following goals:
-
-- make cduce
-  compiles the CDuce command line interpreter
-
-- make dtd2cduce
-  compiles the dtd2cduce tools (converts DTD to CDuce types)
-
-- make webiface
-  compiles the CDuce web interface interpreter (to be used as a CGI script)
-
-- make local_website
-  compiles in the web/www/ subdirectory the HTML files of CDuce website
-  (including the tutorial)
-
-- make all
-  equivalent to (make cduce; make dtd2cduce; make local_website)
-
-
-Makefile accepts the following options, which can take the values
-true or false.
-
-NATIVE=true   : use the OCaml native code compiler (ocamlopt) to build CDuce
-NATIVE=false  : use the OCaml bytecode compiler (ocamlc)
-  default: true  (the native code version is much faster)
-
-PXP_WLEX=true : use wlex for parsing UTF-8 XML files
-PXP_WLEX=false: use ocamllex for parsing UTF-8 XML files
-  default: false (ocamllex is faster; wlex is more compact)
-
-Usage, e.g.:
-  make cduce NATIVE=false
-
-
-------------------------------------------------------------------------------
-
-Efficiency issues:
-
-- OCamlnet: if you plan to load XML file with encodings other than
-  UTF-8, it is advised to use the CVS version of OCamlnet:
-    http://sourceforge.net/cvs/?group_id=19774  
-  Indeed, the netconversion module in the latest release (0.95) was
-  very slow, and it has been rewritten since then.
-
+See the INSTALL file.

Makefile.conf

@@ -10,6 +10,11 @@ PXP_WLEX = false
 # include support for expat
 EXPAT = false
 
+# Installation directory
+# cduce and dtd2cduce => $(PREFIX)/bin
+# cduce.1 => $(PREFIX)/man/man1
+PREFIX = /usr/local
+
 # Customize the following variables to match the settings
 # of your local web server
 WEB_PREFIX = /var/www

Makefile.distrib

@@ -51,18 +51,17 @@ else
 	LINK = $(CAMLC) -custom -linkpkg gramlib.cma
 endif
 
-all: cduce dtd2cduce website validate
+all: cduce dtd2cduce website
 
 
 install: all
 	mkdir -p $(PREFIX)/bin/
 	mkdir -p $(PREFIX)/man/man1/
-	install -m755 cduce dtd2cduce validate $(PREFIX)/bin/
+	install -m755 cduce dtd2cduce $(PREFIX)/bin/
 	install -m644 doc/cduce.1 $(PREFIX)/man/man1/
 
 uninstall:
-	rm  $(PREFIX)/bin/cduce $(PREFIX)/bin/dtd2cduce $(PREFIX)/bin/validate\
-	 $(PREFIX)/man/man1/cduce.1
+	rm  $(PREFIX)/bin/cduce $(PREFIX)/bin/dtd2cduce $(PREFIX)/man/man1/cduce.1
 
 # Source directories 
 

web/index.xml

@@ -113,7 +113,7 @@ efficiently).</li>
 </ul>
 
 <p>
-Some of CDuce peculiar features:
+Some features particular to CDuce:
 </p>
 <ul>
 <li> XML objects can be manipulated as first-class citizen values: