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 Ӓ (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

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.