NAME

convickt - convert INTERCAL files between formats

SYNOPSIS

convickt incharset outcharset [paddingrule [arrayname]]

DESCRIPTION

This manual page describes the convickt command. Fuller documentation is available via the command info convickt

convickt converts INTERCAL programs from one character set to another; it takes input from standard input and sends its output to standard output.

OPTIONS

For incharset and outcharset

atari: Interpret the input as being ASCII-7 Atari syntax INTERCAL, as is used by the Atari INTERCAL-72 compiler, J-INTERCAL, and C-INTERCAL default syntax, or output in that syntax.
baudot: Interpret the input as being in CLC-INTERCAL's extended Baudot syntax, or output in that syntax.
ebcdic: Interpret the input as being in the CLC-INTERCAL dialect of EBCDIC, or output in that syntax.
latin1: Interpret the input as being Latin-1 Princeton syntax INTERCAL, as is used by default by CLC-INTERCAL and also readable by C-INTERCAL with the -X switch, or output in that syntax.

For paddingrule

zero: Pad the irrelevant bits in ASCII-7 and Baudot output with zeros.
printable: Set the values of the irrelevant bits in ASCII-7 and Baudot output to try to cause the output to stay within character range 32-126. This option is the default. (Note that paddingrule is irrelevant for 8-bit character sets like Latin-1 and EBCDIC).
random: Pad the irrelevant bits in ASCII-7 and Baudot output with random data, except that outputing an all-bits-zero octet is avoided.

CAVEATS

Not all conversions are possible, due to the character sets having different characters available. In most cases, an unconvertible or invalid character will be converted to a 0 (padded appropriately); the exception is that if a tab cannot be converted, it will instead be converted to a single space (so that INTERCAL programs still run if converted to Baudot). Using atari as an input or output character set will literally convert characters which differ between Atari and Princeton syntax without checking to see whether they are being used as operators or not.

If arrayname is given, then instead of outputting the converted text literally, it will be output as portable (that is, legal in INTERCAL-72, C-INTERCAL, J-INTERCAL and CLC-INTERCAL) INTERCAL that dimensions the tail array given as arrayname and assigns each byte of the output to an element of that array; this is mostly useful for producing Baudot text for CLC-INTERCAL-style array IO.

AUTHOR

convickt and this manual page were written by Alex Smith.