996
|
1 This directory contains the documentation (such as it is) for INTERCAL.
|
|
2
|
|
3 READ.ME
|
|
4 This file.
|
|
5
|
|
6 intercal.mm:
|
|
7 Masters for the INTERCAL manual (needs pic to render illos)
|
|
8 This has been carefully proofread against the original paper
|
|
9 version.
|
|
10
|
|
11 THEORY
|
|
12 Implementation notes on the C-INTERCAL implementation.
|
|
13
|
|
14 chip.spec:
|
|
15 Christian Brunschen's spec sheet for the INTERCAL chip.
|
|
16
|
|
17 ick.txi:
|
|
18 Master for the Revamped reference manual, a newer manual
|
|
19 independent of the old one.
|
|
20
|
|
21 Note 1: The TeX version we formerly distributed has been dropped. The
|
|
22 combination of groff and pic does an effective job of rendering the
|
|
23 illustrations and is easier to maintain.
|
|
24
|
|
25 Note 2: The supplemental reference manual, ick.txt, has been merged
|
|
26 into the intercal manual. (It is still possible to generate the
|
|
27 original; see the Makefile.)
|
|
28
|
|
29 Note 3: The flat-ASCII directly transcribed from the paper original is
|
|
30 also gone. You can regenerate something very close to it with `make
|
|
31 original.txt'. The differences will be (a) page breaks may fall in
|
|
32 different places, (b) the circuit diagrams present in the paper
|
|
33 version but absent in the ASCII transcription are instead poorly
|
|
34 approximated with ASCII boxology, (c) every "butchered Roman numeral"
|
|
35 is preceded and followed by a line break, (d) the hanging-indent list
|
|
36 of Princeton compiler options has all marks above each description,
|
|
37 rather than to its left.
|
|
38
|
|
39 The aim of these changes was to reduce to one the number of manual masters that
|
|
40 need to be maintained for the original manual, which can both produce the
|
|
41 original INTERCAL-72 manual and the revised version that existed up to about
|
|
42 version 0.18. The revised version proved to be unportable and impractical; it's
|
|
43 still worth a read, but for up-to-date information available in a range of
|
|
44 formats it's worth reading the Revamped manual instead. |