996
|
1 .TH CONVICKT 1
|
|
2 .\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
|
|
3 .\" other parms are allowed: see man(7), man(1)
|
|
4 .\"
|
|
5 .\" Created by Alex Smith; licensed under GNU GPL v2 or later.
|
|
6 .SH NAME
|
|
7 convickt \- convert INTERCAL files between formats
|
|
8 .SH SYNOPSIS
|
|
9 .B convickt
|
|
10 .I "incharset outcharset [paddingrule [arrayname]]"
|
|
11 .SH "DESCRIPTION"
|
|
12 This manual page describes the
|
|
13 .BR convickt
|
|
14 command.
|
|
15 Fuller documentation is available via the command
|
|
16 .B info convickt
|
|
17 .
|
|
18 .PP
|
|
19 .B convickt
|
|
20 converts INTERCAL programs from one character set to another; it takes
|
|
21 input from standard input and sends its output to standard output.
|
|
22 .SH OPTIONS
|
|
23 For
|
|
24 .I incharset
|
|
25 and
|
|
26 .I outcharset
|
|
27 .TP
|
|
28 .B atari
|
|
29 Interpret the input as being ASCII-7 Atari syntax INTERCAL, as is used
|
|
30 by the Atari INTERCAL-72 compiler, J-INTERCAL, and C-INTERCAL default
|
|
31 syntax, or output in that syntax.
|
|
32 .TP
|
|
33 .B baudot
|
|
34 Interpret the input as being in CLC-INTERCAL's extended Baudot
|
|
35 syntax, or output in that syntax.
|
|
36 .TP
|
|
37 .B ebcdic
|
|
38 Interpret the input as being in the CLC-INTERCAL dialect of EBCDIC, or
|
|
39 output in that syntax.
|
|
40 .TP
|
|
41 .B latin1
|
|
42 Interpret the input as being Latin-1 Princeton syntax INTERCAL, as is
|
|
43 used by default by CLC-INTERCAL and also readable by C-INTERCAL with
|
|
44 the
|
|
45 .B \-X
|
|
46 switch, or output in that syntax.
|
|
47 .PP
|
|
48 For
|
|
49 .I paddingrule
|
|
50 .TP
|
|
51 .B zero
|
|
52 Pad the irrelevant bits in ASCII-7 and Baudot output with zeros.
|
|
53 .TP
|
|
54 .B printable
|
|
55 Set the values of the irrelevant bits in ASCII-7 and Baudot output to
|
|
56 try to cause the output to stay within character range 32-126. This
|
|
57 option is the default. (Note that
|
|
58 .I paddingrule
|
|
59 is irrelevant for 8-bit character sets like Latin-1 and EBCDIC).
|
|
60 .TP
|
|
61 .B random
|
|
62 Pad the irrelevant bits in ASCII-7 and Baudot output with random data,
|
|
63 except that outputing an all-bits-zero octet is avoided.
|
|
64 .SH CAVEATS
|
|
65 Not all conversions are possible, due to the character sets having
|
|
66 different characters available. In most cases, an unconvertible or
|
|
67 invalid character will be converted to a 0 (padded appropriately); the
|
|
68 exception is that if a tab cannot be converted, it will instead be
|
|
69 converted to a single space (so that INTERCAL programs still run if
|
|
70 converted to Baudot). Using
|
|
71 .B atari
|
|
72 as an input or output character set will literally convert characters
|
|
73 which differ between Atari and Princeton syntax without checking to
|
|
74 see whether they are being used as operators or not.
|
|
75 .PP
|
|
76 If
|
|
77 .I arrayname
|
|
78 is given, then instead of outputting the converted text literally, it
|
|
79 will be output as portable (that is, legal in INTERCAL-72, C-INTERCAL,
|
|
80 J-INTERCAL and CLC-INTERCAL) INTERCAL that dimensions the tail array
|
|
81 given as
|
|
82 .I arrayname
|
|
83 and assigns each byte of the output to an element of that array; this
|
|
84 is mostly useful for producing Baudot text for CLC-INTERCAL-style
|
|
85 array IO.
|
|
86 .SH AUTHOR
|
|
87 .B convickt
|
|
88 and this manual page were written by Alex Smith.
|