PTRANS(1) BSD General Commands Manual PTRANS(1)NAMEptrans — ptrans command manual page
SYNOPSISptrans [-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 map‐
ping 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 vari‐
able, 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 ALSOlibutf-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
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.
BSD April 12, 1998 BSD
