/usr/share/doc/enca/README.md is in enca 1.19-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 | # Enca - guess and convert encoding of text files
[](https://travis-ci.org/nijel/enca)
[](https://codecov.io/github/nijel/enca?branch=master)
[](https://scan.coverity.com/projects/nijel-enca)
[](https://coveralls.io/r/nijel/enca?branch=master)
## Copyright
Copyright (C) 2000-2003 David Necas (Yeti) <yeti@physics.muni.cz>
Copyright (C) 2009-2016 Michal Cihar <michal@cihar.com>
## Description
Enca (Extremely Naive Charset Analyser) consists of two main components:
* libenca, an encoding detection library. It currently supports
Belarusian, Bulgarian, Croatian, Czech, Estonian, Hungarian, Latvian,
Lithuanian, Polish, Russian, Slovak, Slovene, Ukrainian, Chinese, and
some multibyte encodings independently on language. The API should be
relatively stable (to be read as `it will either change only
marginally, or very drastically').
* enca, a command line frontend, integrating libenca and several
charset conversion libraries and tools (GNU recode, UNIX98 iconv,
perl Unicode::Map, cstocs).
## Installation
Enca should compile and work on every POSIX.1 compliant system with ISO C
compiler, and actually compiles on many noncompliant systems too (see below
for list dependencies). If you have some of following additional tools,
Enca can use them as external converters:
* GNU recode and the associated recoding library
* Perl charset converters Unicode::Map8 or Unicode::Map
* cstocs, the famous Czech charset converter
Optional features:
* Compilation of GNU recode library interface is controlled by
`--with-librecode[=DIR]`, `--without-librecode`
configure parameters. It is compiled in by default when found.
Optionally, you can specify a DIR; librecode include files will be
then searched in DIR/include and the library itself in DIR/lib.
* Compilation of UNIX98 iconv interface is controlled by
`--with-libiconv=[DIR]`, `--without-libiconv`
configure parameters. It is compiled in by default when found
and considered usable. Optionally, you can specify a DIR; libiconv
include files will be then searched in DIR/include and the library
itself in DIR/lib.
* Compilation of interface to external converter programs is controlled by
`--enable-external`, `--disable-external`
configure parameters. By default is is compiled in.
Don't even try to compile Enca on system not supporting following ISO C and
POSIX features:
* Function prototypes.
* Basic ISO C headers and functions declared there:
- assert.h, ctype.h, math.h, stdarg.h, stdio.h, stdlib.h
- any (working) one of string.h, strings.h, memory.h
- unistd.h, sys/stat.h, sys/types.h
For the impatient: Run
./configure
make
make check
make install
as usual.
## License
Enca can be copied and/or modified under the terms of version 2 of
GNU General Public License. Please see COPYING for details.
## Web resources
Enca can be found at http://github.com/nijel/enca/, you can download
tarballs from http://dl.cihar.com/enca/.
## Bugs
Report problems at <https://github.com/nijel/enca/issues>. Some known bugs have
been collected in BUGS section of enca manual page.
## 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 DEVELOP.md describes what needs to be done to add a new
encoding or language to Enca.
The directory devel-docs/html contains Enca library API documentation in
HTML form.
|