Commit 11654b8a authored by Pietro Abate's avatar Pietro Abate
Browse files

[r2002-10-10 09:11:23 by cvscast] Empty log message

Original author: cvscast
Date: 2002-10-10 09:11:23+00:00
parent 3e3d3a2a
Main developer:
Alain Frisch
Research project leaders, documentation:
Alain Frisch
Giuseppe Castagna
Véronique Benzaken
Code contribution:
Cédric Miachon (author and maintainer of the CQL subset)
Julien Demouth (original implementation of the OCaml/CDuce interface)
Stefano Zacchiroli (original implementation of the XML Schema support)
0.5.0
* Port to OCaml 3.10, with the help of Nicolas Pouillard
0.4.2
- Language:
* Added int_of_char
- Bug fix:
* "match 1 with (x := `nil) -> x" raised an assert failure
0.4.1
- Tools:
* Error message when using --mlstub without the built-in OCaml interface
* Improvements to the type pretty-printer
* "include" uses the -I options
- Language:
* New Caml_int builtin type
* The // construction no longer stops at the first matched subtree
on each branch
* New "dump_xml" and "dump_xml_utf8", equivalent to the composition
of print and print_xml, but more efficient
- Implementation:
* New subtyping algorithm
* Small improvement to the pattern matching compiler
* Improve type-checking time for map
* Improve type-checking of record expressions
* Don't display warnings for unused branches in ghost (generated) pattern
matching
- Bug fix:
* "eval" can now be called several times and use the toplevel environment
* use "open_out_bin" (needed for Cygwin installation)
* "open" allowed as tag name
* exceptions raised by the expat parser and by the dump_to_file
primitives are now catchable
* work-around the double close bug in OCaml
0.4.0pl1
- Packaging bug
0.4.0
- Adapted to OCaml 3.09.
- To build the OCaml/CDuce interface, OCaml sources are now needed.
0.3.92
- Tools:
* Build and install dtd2cduce when PXP is available.
* Display of location for errors and warnings compatible with OCaml.
- Language:
* Better error messages for xtransform.
- Bug fix:
* Forgot PLIST.godi in the package.
0.3.91
- Tools:
* Get rid of cdo2ml and mlcduce_wrapper. Now included in cduce.
- Bug fix:
* Internal uid collision when using OCaml externals.
* Makes "String.length" works (String used to resolve to the CDuce type).
0.3.9
- Language:
* Added split_atom, make_atom. Removed atom_of.
* Added char_of_int built_in function.
* Now int_of also accepts octal binary and hexadecimals.
* The field access also works for XML element attributes.
* More catchable exceptions (for load_xml, load_file, etc).
* namespaces, schemas, "using" identifiers are now exported.
* "open" statement.
- Implementation:
* More efficient implementation of records at runtime.
* Clean-up of the internal representation.
* The XML Schemas are now parsed only at compile time.
* The automata for pattern matching are now produced at compile time.
- Tools:
* The functionality of cdo2ml is now assured by cduce itself, with
the --mlstub option.
* Remove the --dump option (which was deprecated).
* Remove support for sessions in the web prototype.
- Bug fixes:
* Correct handling of external references with expat.
* Installation problem under some BSD (using "install -c").
0.3.2
* Bug fix in configure
0.3.1
- Bug fix:
* configure must not require pxp
* inclusion of external entities with expat
* META.in, cduce_mktop missing in package
* several bugfixes for XML Schema
* Adapt to ocaml-expat 0.9.1
* don't build cdo2ml, mlcduce_wrapper when ocaml iface not available
- Language:
* Can now preserve namespaces when parsing XML or when creating XML elements
* "or" is now equivalent to ||
0.3.0
- Language:
* Warning for capture variables and projections that always return the empty
sequence.
* Major rewrite of the support for XML Schema
* removed print_schema directive
* removed the "kind" selector (e.g. S # t as element)
* include,import implemented
* support wildcards any,anyAttrivbute
* support xsi:nil
* support xsd:decimal,xsd:float
* many bug fixes
* Removed the syntax "external {...}", replaced with
"unit.val with { ty1 ty2 ... }".
* Removed the syntax H:val, replaced with H.val.
* Removed the syntax S#t, replaced with S.t.
* Overloaded the dot (record field acces, CDuce, OCaml, Schema units).
A dot in an identifier must now be escaped with a backslash, e.g. x\.y
* Identifiers (for types, values) are now qualified names.
* float_of: String -> Float
* Syntax modifications for records and attributes:
- ".." to denote open record types/patterns:
open record: { l1=t1 l2=t2 .. }
closed record: { l1=t1 l2=t2 }
- the ";" between fields is optional even for records
(used to be optional only for attributes)
* Keywords are now allowed as type names
* Concatenation @ allowed in types
* Record concatenation + allowed in types
* Changed "string://" URL-pseudo schema to "string:"
* Better resolution of external entities for PXP and expat
- Tools:
* A new tool cduce_mktop produces customized CDuce toplevels with embedded
OCaml externals.
* Removed the validate tool.
* Don't build dtd2cduce by default (it requires PXP). An online
version is available at http://www.cduce.org/dtd2cduce.html
- Implementation:
* Various bug fixes.
* More efficient hash-consing of types.
* improved #print_type (does not use the abbreviation for the printed type).
- Distribution:
* MIT license.
* CDuce can be built without support for PXP.
- CQL:
* Rewrote the optimization (pushing projections).
* The syntax for "where" clause is now simply an "and"-separated
list of conditions ("or" is no longer supported).
* Better types for "min","max","distinct_values" operators.
0.2.2
- Language:
* Runtime type-check: (e :? t) raises an exception when e doesn't
have type t; the exception is an explanation of why this is not the case.
(The actual message may change in the future.)
* Better return type for load_xml, defined as:
AnyXml=<(Atom) (Record)>[ (AnyXml|Char)* ]
* New style for comments: /* ... */
Simple and double quotes within these comments are not handled
specially. Moreover, these comments cannot be nested.
The new style should be used for textual comments (which can include
the simple quote); the old style is better for ignoring pieces of code.
* Pattern guard /p in regexps to match the current tail. This can be used
for setting "markers" without capturing anything, e.g.:
[ (/(x:=1) ...) | (/(x:=2) ...) ]
Back to the old semantics for default value patterns in regexps
(they do capture an element).
* New syntax {...; l = p else p'; ... }. p' is applied
to the whole matched record when p does not match (or when
the field is missing). Equivalent to:
{ ...; l = p; ...} | ({...;...} & p')
* Punning in record/attribute expressions and patterns.
{ x; y } is a shorthand for {x=x;y=y}.
* New syntax for R**n in regular expressions, equivalent
to R...R (n times), where n > 0.
* Interval arithmetic for the * operator.
* Warning for potential division by 0.
* New "system", "exit", "getenv" built-in functions.
- Toplevel, interpreter, compiler:
* New #silent, #verbose directives.
* New --script option.
* Removed the warning "no caml interface".
- Compilation:
* Better compilation of sequence capture variables.
Now, [ ... x::Any* ] is as efficient as [ ... ; x ]. Can also be written
[ ... /x _* ]. The [ ... ; ... ] syntax is no longer necessary
and might be deprecated.
- Bug fixes, including:
* Bug fixes in configure/Makefile for Cygwin.
* Bug fix for the compilation of complex patterns with records.
* Fixed a little bit support for XML Schema, but still largely broken.
* Fix --stdin.
* Bug fix in print_xml (do not create a namespace decl for "xml:").
- Distribution:
* apps-cduce-cvs GODI package is updatable.
* The release tarball does not contain the CDuce website, only
the HTML documentation (memento, tutorial, manual).
0.2.1
- string:// scheme for load_xml and others
- code updated to OCaml 3.08.1, PXP 1.1.95
- NOTE: support for namespaces in XML Schema may be broken
0.2.0
- OCaml/CDuce interface.
- Language:
* Support for URLs in load_xml, load_html, load_file, and schemas:
e.g. you can write `` load_html "http://www.cduce.org/" ''
(need either the ocurl package or the netclient package).
* More advanced (and documented) support for XML Schemas.
* Preliminary integration of CQL query language that is:
select e from p1 in e1, ... ,pn in en where e'.
* Allow structured constants in default value patterns (p := c).
* Default value patterns in regexps don't consume an element.
* Logical operators &&, ||, and not.
* New syntax for currified functions
fun (p1 : t1)...(pn : tn) : t = ...
- Incompatible changes:
* argv is now an operator of type [] -> [ String* ].
* The --dump, --load, --save options are deprecated.
* Changes to the command line. "--pxp" is replaced with "--no expat".
- Implementation:
* Code upgraded to Ocaml 3.07.
* Major cleaning in progress.
* Added internal support for abstract data types.
* Using ulex instead of wlex.
* Sources can now be in utf8.
* Separate compilation.
* Lazy implementation of @.
- Other:
* Added configure script.
* Various Makefile improvements.
- Bug fixes:
* Bug fixes in the parser. Tuples are now ok in regexps.
0.1.1
* Various bug fixes (expat might now work)
* Sequencing operator e1;e2 (equivalent to: let [] = e1 in e2)
* Encoded references
0.1.0
* Support for XML Namespaces
* Better support for expat; clean Makefile
* Get rid of ;; and let fun in examples
* Optional ; for record in attribute position (values and types/patterns)
* Split --dump into --load and --save
* Better handling of strings (specific node in AST)
* Map, transform: tail-recursive implementation
* Preliminary support for XML Schema
* Various bug fixes
0.0.91
* Second alpha release
* Bug fixes and syntax changes (e.g. making "fun" optional in "let fun")
* Experimenting with expat support (see expat/README)
0.0.9
* First public release (alpha release)
Installation Notes for CDuce
============================
CDuce is written in the OCaml programming language. It has been
successfully compiled under Intel Linux, Mac OSX, SunOS 5.7, FreeBSD 4.7.
and Windows XP.
(See INSTALL.WIN32 for installation under Windows)
------------------------------------------------------------------------------
Prerequisites
------------------------------------------------------------------------------
An easy way to get a system ready to compile CDuce is to use
the GODI distribution:
http://www.ocaml-programming.de/godi/
It includes all the mandatory and optional packages listed below,
and also the special modules needed to build the OCaml/CDuce interface.
Mandatory packages:
-------------------
Before compiling CDuce, you need to install recent releases of the
following packages:
ocaml >= 3.10
http://caml.inria.fr/ocaml/distrib.html
findlib >= 1.0.3
http://www.ocaml-programming.de/packages
ulex >= 1.0
http://www.cduce.org/download
pcre-ocaml >= 5.03
http://www.ai.univie.ac.at/~markus/home/ocaml_sources.html
ocamlnet >= 0.98
http://www.ocaml-programming.de/packages
Additional optional packages:
-----------------------------
* You'll probably want to build CDuce with an XML parser. You will need one of:
pxp >= 1.1.95
http://www.ocaml-programming.de/packages/documentation/pxp/index_dev.html
ocaml-expat >= 0.9.1
http://home.wanadoo.nl/maas/ocaml/
* CDuce can use one the the ocurl and netclient library to fetch external
URLs. You will need one of:
ocurl >= 0.15
http://sourceforge.net/projects/ocurl/
netclient >= 0.90.1
http://www.ocaml-programming.de/programming/netclient.html
netclient support only the http protocol.
curl supports in addition https, ftp, and other protocols.
Important notes:
----------------
- pcre-ocaml: you may also need to install the PCRE library
from http://www.pcre.org/ (use version >=4.4)
[red-hat users: pcre (rawhide) packages may not work with the
latest pcre-ocaml versions, use tarballs]
In this case, configure it with the --enable-utf8 option.
>= 5.03 recommended but previous versions may work
- PXP:
It is enough to build support for UTF8 and ISO-8859-1 ocamllex-lexers:
./configure -without-wlex -without-wlex-compat -lexlist utf8,iso88591
You can also build pxp with wlex support (more compact code). This
can be done by installing wlex runtime support library *before* pxp
http://www.eleves.ens.fr/home/frisch/soft.html#wlex
and build pxp -with-wlex*. When building CDuce you still have the
choice whether to use wlex or ocamllex (to choose wlex,
do ./configure --with-pxp_wlex or set PXP_WLEX=true in Makefile.conf).
- ocurl:
you may also need to install libcurl (http://curl.haxx.se/libcurl/)
- ocaml-expat:
you may also need to install libexpat (http://expat.sourceforge.net/)
------------------------------------------------------------------------------
Compilation
------------------------------------------------------------------------------
There is a configure script. It will check for the presence of
mandatory packages, and detect automatically optional ones. It will
also set installation directories. Running the script produces a
Makefile.conf file. You can get usage information about the script
with: ./configure --help
Alternatively, it is also possible to copy Makefile.conf.template to
Makefile.conf and modify it by hand.
The usual command line for configuring and building CDuce:
./configure && make all && make install
To see all the configuration options:
./configure --help
You need a GNU Make (or equivalent). The Makefile defines the following goals:
- make help
print a summary of what follows
- make all
build binaries and libraries (does not build dtd2cduce)
- make cduce
compiles the CDuce command line interpreter
- make dtd2cduce
compiles the dtd2cduce tools (converts DTD to CDuce types).
The PXP package must be available to build dtd2cduce.
If you cannot build dtd2cduce locally, you can use on online
version available at this URL:
http://www.cduce.org/dtd2cduce.html
- make doc
compiles in the subdirectory web/doc the HTML documentation for CDuce
- make all
- make install
installs binaries into $(BINDIR), manpages into $(MANDIR)/man1,
and registers the cduce_lib library with findlib.
- make clean
back to the starting point
- make uninstall
removes installed files
------------------------------------------------------------------------------
Building the CDuce/OCaml interface
------------------------------------------------------------------------------
If you want to build the OCaml/CDuce interface, you need a copy
of the OCaml source tree matching your current OCaml version.
You must pass the location of this tree to the configure script:
./configure --mliface=$HOME/ocaml-3.09
------------------------------------------------------------------------------
Note on XML parsers
------------------------------------------------------------------------------
When CDuce is built with support for both expat and PXP, it uses by default
expat to parse XML files. You can still use PXP by adding "--no expat" to
the CDuce command line.
- error messages:
The error messages provided by expat when parsing ill-formed XML documents
are less informative than those given by PXP.
- efficiency:
* expat is more efficient than PXP, and produces smaller executables.
* for PXP, ocamllex lexers are more efficient than wlex lexers.
ftp://ftp.leo.org/pub/altlinux/Sisyphus/files/i586/RPMS/findlib-0.8-alt2s.i586.rpm
ftp://ftp.leo.org/pub/altlinux/Sisyphus/files/i586/RPMS/pxp-1.1.93-alt2s.i586.rpm
ftp://ftp.leo.org/pub/altlinux/Sisyphus/files/i586/RPMS/pcre-ocaml-4.28.3-alt3s.i586.rpm
<box title="Rpm packages" link="rpm">
<p>
In order to install the cduce rpm packages you will need to install
the following packages
<pre>
ocaml >= 3.06
findlib >= 0.8
pcre-ocaml>= 4.22
ocamlnet >= 0.96
pxp >= 1.1.93
expat >= 1.95.6 (just for the expat package)
<pre>
</p>
<p> All these packages can be found in the Altlinux distribution: for Asia
<a href="ftp://ftp.altlinux.ru/pub/distributions/ALTLinux/Sisyphus/files/i586/RPMS/">i586</a>,
<a href="ftp://ftp.altlinux.ru/pub/distributions/ALTLinux/Sisyphus/files/SRPMS">src</a>; European mirror <a href="ftp://ftp.leo.org/pub/altlinux/Sisyphus/files/i586/RPMS/">i586</a>, <a href="ftp://ftp.leo.org/pub/altlinux/Sisyphus/files/SRPMS/">src</a>
<p>
<p>N.B. rpm will check that you installed all these packages. If you have them installed but not via rpm then install CDuce by <code>rpm -Uvh --nodeps cduce-X.X.X-X.rpm</code>
<p>
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 recent
releases of the following packages:
cygwin
http://www.cygwin.com
ocaml
http://caml.inria.fr/ocaml/distrib.html
findlib
http://www.ocaml-programming.de/packages
wlex
http://www.eleves.ens.fr/home/frisch/soft.html#wlex
pcre-ocaml
http://www.ai.univie.ac.at/~markus/home/ocaml_sources.html
ocamlnet
http://sourceforge.net/projects/ocamlnet
pxp
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
Lib/
libpcre
pcre **both binaries and sources**
you may also find useful to install the following packages
Editors/
emacs or vim (no trolls)
Net/
openssh
ncftp
Devel/
cvs
Utils/
diff
patch
then proceed with installation
2) Download (we suggest in /usr/src) and install Ocaml
[For the impatients: ./configure && make world.opt && make install]
3) Download (guess where) and install findlib
a plain ./configure && make all && make opt && make install
should work
4) Download and install ulex
5) Download and install pcre-ocaml.
6) Download and install ocamlnet
7) PXP:
CDuce requires a development version >= 1.1.93.
Now you can compile CDuce sources as indicated in the INSTALL file
namely
------------------------------------------------------------------------------
Compilation, installation
------------------------------------------------------------------------------
See the INSTALL file.
The package CDuce is released under the terms of an MIT-like license.
Copyright 2005 by Alain Frisch and contributors.
Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
version="%VER%"
requires="%REQ%"
description="Runtime support for CDuce"