Mercurial > repo

comparison interps/c-intercal/inst/share/man/man1/convickt.1 @ 996:859f9b4339e6

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
<Gregor> tar xf egobot.tar.xz
author HackBot
date Sun, 09 Dec 2012 19:30:08 +0000
parents
children
comparison
equal deleted inserted replaced
995:6883f5911eb7 996:859f9b4339e6
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.