DragonFly On-Line Manual Pages

PTRANS(1)              DragonFly General Commands Manual             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 Ӓ (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
     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 12, 1998       DragonFly 6.5-DEVELOPMENT