Camomile 0.6.2:

This is an alpha release of Camomile library package.  Camomile is a
comprehensive Unicode library for ocaml.  Camomile provides Unicode
character type, UTF-8, UTF-16, UTF-32 strings, conversion to/from
about 200 encodings, collation and locale-sensitive case mappings, and
more.

Copyright 2001, 2002, 2003, 2004 Yamagata Yoriyuki

This library is free software; you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

The GNU Lesser General Public Licence (LGPL) is contained in the file COPYING.

The following files are authored by different persons.  For their
licenses, see the relevant notice of each file or directory.

configure.in Makefile.in : Jean-Christophe FILLIATRE
	Licensed by LGPL

locales : International Business Machines : 
	derived from the ICU package.  see locales/licence.html
mappings : Free Software Foundation : 
	derived from glibc.  Licensed by LGPL
	(CP932 has a different origin.  See the premable of the file CP932)
unidata : Unicode Inc. : see unidata/README

1. Installation

The library is designed to work all platform supported by ocaml,
but currently the build procedure requires GNU tools. (GNU Make, grep,
and sh command for run the configure.)

In the top of the source directory, do the following.
	$ ./configure
	$ make
Become root and do the following.
	# make install

The installation directories depend on whether you have findlib, which
is automatically detected.  If you do not have findlib, Library files
(camomile.cma, camomile.cmxa, caomileunpack.cma, camomileunpack.cmxa)
and interface files (public/*.cmi) are installed to ocaml standard
library directory.  If you have findlib, these files are governed by
findlib and installed as a package named "camomile".  For either
cases, data files are put under /usr/local/share/camomile by default.
If you give the configure option as
	$ ./configure --datadir=XXXX 
data files are placed under XXXX/camomile.

If you have findlib, you can uninstall the library by
	# make uninstall

If you have ocamldoc,
	$ make dochtml
creates dochtml directory in the source directory, and HTML
documentation.  Similarly,
	$ make doclatex
	$ make doctexi
	$ make man
creates LaTeX, Texi, man documentation respectively.

2. Using libraries

2.1 Packing and unpacking

There are two flavor of libraries, one is packed and the other is not
packed.

To use the packed library, link camomile.cm(x)a to your program in the
case you do not use findlib.  In the case with findlib, using the
packed library is default.  When using the packed library, each module
in camomile is reffered as Camomile.<module name>.  In this way you
can avoid name collision with other libraries and your program.  On
the other hand, the packed library would consume more memory.

If you want to use unpacked library, link camomileunpack.cm(x)a, in
the case without findlib, or use subpackage camomile.unpack with
findlib.

2.2 Individual modules.

See *.mli files.

3. Author

You can contact the author by yori@sourceforge.net

4. Acknowledgement

Peter Jolly provided CP932 conversion table.
Kawakami Shigenobu contributed findlib support.
Peter Jolly, Kawakami Shigenobu provided several bug fixes.