This directory contains the documentation (such as it is) for INTERCAL.

READ.ME:
	This file.

Makefile:
        Machine-readable rules for building the documentation.

intercal.mm:
	Masters for the INTERCAL manual (needs pic to render illos)
	This has been carefully proofread against the original paper
	version.

ick.texi:
	Master for the Revamped reference manual, a newer manual
	independent of the old one.

THEORY.txt:
	Implementation notes on the C-INTERCAL implementation.

build-process.txt:
    Notes on how the C-INTERCAL build process works.

chipspec.txt:
	Christian Brunschen's spec sheet for the INTERCAL chip.

RFC-DRAFT.roff:
    A draft of an INTERCAL-related RFC by Eric S. Raymond.

ick.1:
convickt.1:
    Man pages for ick and convickt.

fdl-1-2.texi:
    License for the Revamped Manual.

fixtoc.pl, fix83.pl, ickstyle.css, tidy.cfg:
    Helper files used to build the HTML version of the Revamped Manual.

Note 1: The TeX version we formerly distributed has been dropped.  The
combination of groff and pic does an effective job of rendering the
illustrations and is easier to maintain.

Note 2: The supplemental reference manual, ick.txt, has been merged
into the intercal manual. (It is still possible to generate the 
original; see the Makefile.)

Note 3: The flat-ASCII directly transcribed from the paper original is
also gone.  You can regenerate something very close to it with `make
original.txt'.  The differences will be (a) page breaks may fall in
different places, (b) the circuit diagrams present in the paper
version but absent in the ASCII transcription are instead poorly
approximated with ASCII boxology, (c) every "butchered Roman numeral"
is preceded and followed by a line break, (d) the hanging-indent list
of Princeton compiler options has all marks above each description,
rather than to its left.

The aim of these changes was to reduce to one the number of manual
masters that need to be maintained for the original manual, which can
both produce the original INTERCAL-72 manual and the revised version
that existed up to about version 0.18. 

However, the revised version proved to be unportable and impractical;
it's still worth a read, but for up-to-date information available in a
range of formats it's worth reading the Revamped manual instead.
