freeswitch/libs/apr-iconv-1.1.1
Michael Jerris 245060e5a9 rename
git-svn-id: http://svn.freeswitch.org/svn/freeswitch/trunk@3738 d0543943-73ff-0310-b7d9-9358b9ac24b2
2006-12-19 21:56:27 +00:00
..
autom4te.cache rename 2006-12-19 21:56:27 +00:00
build rename 2006-12-19 21:56:27 +00:00
ccs rename 2006-12-19 21:56:27 +00:00
ces rename 2006-12-19 21:56:27 +00:00
docs rename 2006-12-19 21:56:27 +00:00
include rename 2006-12-19 21:56:27 +00:00
lib rename 2006-12-19 21:56:27 +00:00
util rename 2006-12-19 21:56:27 +00:00
AUTHORS rename 2006-12-19 21:56:27 +00:00
CHANGES rename 2006-12-19 21:56:27 +00:00
COPYING rename 2006-12-19 21:56:27 +00:00
LICENSE rename 2006-12-19 21:56:27 +00:00
Makefile.in rename 2006-12-19 21:56:27 +00:00
NOTICE rename 2006-12-19 21:56:27 +00:00
README rename 2006-12-19 21:56:27 +00:00
apriconv.dsp rename 2006-12-19 21:56:27 +00:00
buildconf rename 2006-12-19 21:56:27 +00:00
configure rename 2006-12-19 21:56:27 +00:00
configure.in rename 2006-12-19 21:56:27 +00:00
libapriconv.dsp rename 2006-12-19 21:56:27 +00:00
libapriconv.rc rename 2006-12-19 21:56:27 +00:00

README

	ICONV - Charset Conversion Library. Version 1.0
	-----------------------------------------------

This distribution contains the library (libiconv.a and .so) for
conversion between various charsets (character encoding schemes)
and the command line utility (iconv).

Syntax of the library functions (iconv_open, iconv, iconv_close)
and the utility is described in the man pages.

Features of the library:
	- small size: the actual conversion methods are located
	  in dynamically loaded shared modules, representing
	  either a character encoding scheme (CES), or a coded
	  character set (CCS); 
	- open module API: adding new modules (both CESs and
	  CCSs) is easy. Although the API has not been documented,
	  it is rather simple to be figured out from the sources;
	- BSD-style copyright;
	- POSIX compliance of iconv_open, iconv and iconv_close
	  functions;
	- support for aliases for charset names via UNIX symbolic
	  links;
	- ISO/IEC 10646 conformance of the internal representation
	  of characters; conversion is always done in two steps:
	  (1) a sequence of zero or more bytes from input buffer
	  coded in the source charset is converted to exactly one
	  valid UCS-4 character and (2) the UCS-4 character is
	  converted to a sequence of zero or more bytes in
	  the target charset to the output buffer;
	- standard sources of CCS tables: all C source files of
	  the tables have been generated by a Perl script from
	  the Unicode and RFC1345 charset mapping tables before
	  being included to the package.

				Konstantin Chuguev
				<Konstantin.Chuguev@dante.org.uk>
				September 2000.