PTRANS(1)

NAME
ptrans - ptrans command manual page

SYNOPSIS
ptrans [-v] [-b] [-t] [-e] [-7] [-8] [-p pagefile] [-i inputfile] [-o outputfile]

DESCRIPTION
The ptrans command converts UTF-8 encoded text files to files with any character encoding. Anything that does not fit requested character mapping is expressed in the HTML format of &#1234; (decimal).

The options are as follows:

-v  Verbose mode.

-b  Pagefile is binary (default).

-t  Pagefile is plain text.

-e  Ignore environment variables.

-7  Produce seven-bit output.

-8  Produce eight-bit output (default).

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

-i inputfile
    Input (default: stdin).

-o outputfile
    Output (default: stdout).

ENVIRONMENT
The ptrans command uses the PTRANS environment variable if no pagefile is specified on the command line. If ptrans does not find the PTRANS variable, it uses the UTRANS environment variable instead.

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

The ptrans command ignores 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. These formats are identical to those used by utrans(1).

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

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

SEE ALSO
libutf-8(3), utrans(1), uhtrans(1), hutrans(1), 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.