|CONVICKT(1)||General Commands Manual||CONVICKT(1)|
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
- 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.
- Interpret the input as being in CLC-INTERCAL's extended Baudot syntax, or output in that syntax.
- Interpret the input as being in the CLC-INTERCAL dialect of EBCDIC, or output in that syntax.
- 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.
- Pad the irrelevant bits in ASCII-7 and Baudot output with zeros.
- 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).
- 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.