DragonFly On-Line Manual Pages

UTRANS(1)              DragonFly General Commands Manual             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
     ANSI X3.159-1989 ("ANSI C89"), 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.

DragonFly 6.5-DEVELOPMENT        April 4, 1998       DragonFly 6.5-DEVELOPMENT