UTRANS(1)

NAME
utrans - utrans command manual page

SYNOPSIS
utrans [-v] [-b] [-t] [-e] [-p pagefile] [-i inputfile] [-o outputfile]

DESCRIPTION
The utrans command converts text files created with any character encoding into UTF-8 format.

The options are as follows:

-v  Uerbose mode.

-b  Pagefile is binary (default).

-t  Pagefile is plain text.

-e  Ignore environment variables.

-p pagefile
    File with the mapping of your 8-bit encoding into Unicode.

-i inputfile
    Input (default: stdin).

-o outputfile
    Output (default: stdout).

ENVIRONMENT
The utrans command uses the UTRANS environment variable if no pagefile is specified on the command line.

It uses the CHARMAPS environment variable to determine the path to the pagefile.

The utrans command igmores the environment variables if the -e switch is used.

FILES
The binary pagefile is simply raw data. The text pagefile follows one of these formats:

    =A2 U+0123
    /xE0 U1234

to map an 8-bit character code into Unicode encoding.

EXAMPLES
The following is an example of a typical usage of the utrans command:

    % utrans -t -p iso8859-2.txt -i source -o index.html

SEE ALSO
libutf-8(3), tuc(1), cat(1) Roman Czybora, The 8859 Alphabet Soup, http://czybora.com/charsets/iso8859.html. G. Adam Stanislav, Whiz Kid Technomagic i18n Tools, http://www.whizkidtech.net/i18n/.

STANDARDS
ansiC, number of other standards.

DIAGNOSTICS
Exit status is 0 on success, 1 on invalid usage, 2 if a file cannot be opened, and 3 if memory allocation fails.

AUTHORS
This manual page was written by G. Adam Stanislav <adam@whizkidtech.net>.

BUGS
No known bugs.