#============================================================================
# Enca v0.10.7 (2003-01-28)  guess and convert encoding of text files
# Copyright (C) 2000-2003 David Necas (Yeti) <yeti@physics.muni.cz>
#============================================================================

1. Description

Enca (Extremely Naive Charset Analyser) consists of two main components:
  * libenca, an encoding detection library.  It currently supports
    Belarussian, Czech, Polish, Russian, Slovak and Ukrainian and some
    multibyte encodings independent on language.
  * enca, a command line frontend, integrating libenca and several
    charset conversion libraries and tools (GNU recode, UNIX98 iconv,
    perl Unicode::Map, cstocs).

It should be noted that enca is still under development. That
particularly means behaviour, features and command line parameters
can change incompatibly or even disappear between any subversions or
subsubversions when I change my mind about what is the right way to
do something.  The libenca API should be relatively stable, which should
be read as `it will either change only very little, or very drastically'.


2. Installation

Please see INSTALL for system requirements, detailed installation
instructions and also for description of optional features that can
be selected at ./configure time.

For the impatient: Run
  ./configure && make && make check && make install
as usual.


3. License

Enca can be copied and/or modified under the terms of version 2 of
GNU General Public License.  Please see COPYING for details.


4. Web resources

Enca can be found at http://physics.muni.cz/~yeti/download/ and its
home page is http://physics.muni.cz/~yeti/software/enca.shtml, but
the author is not able to guarantee stability of these URIs.


5. Bugs

Report problems to <yeti@physics.muni.cz>.  Please include `enca'
in subject.  (Some known bugs have been collected in BUGS section
of enca manual page.)


6. Hacking (with) Enca

Please see TODO for list of things that should be fixed and features to
be implemented and their priority and also for list of things that
definitely shouldn't be implemented.

The file README.devel describes what needs to be done to add a new
encoding or language to Enca and some GNU build system related issues.

The directory devel-docs/html contains Enca library API documentation in
HTML form.

