This is the first (alpha) release of CLC-INTERCAL. It is designed
to be almost compatible with the original (Princeton 1972) compiler.
See the POD included in Language/INTERCAL.pm for a discussion of extensions
and limitations to the language. The name CLC-INTERCAL stands for "INTERCAL
compiler in Perl".

To install the compiler, obtain the tar file (CLC-INTERCAL-x.xx.tar.gz,
for appropriate values of x.xx) and unpack it somewhere. Then change to the
somewhere and type:

    perl Makefile.PL
    make
    make test
    make install

The last step might need to be performed as root. The third step can fail
with a very small probability due to the random compiler bug. This will print
the message "UNEXPLAINABLE COMPILER ERROR OCCURRED". This is normal, but you
are extremely unlikely to see it happen.

To consult the extensive on-line documentation you can use:

    perldoc Language::INTERCAL

The compiler uses nonstandard EBCDIC (1) for all input (including the source
code of INTERCAL programs) and some of the output (some is in ASCII).
Internally, these are converted to an extended Baudot. The two character sets
are fully documented; to consult the documentation use:

    perldoc Charset::EBCDIC
    perldoc Charset::Baudot

(1) ever seen a "standard" EBCDIC?

The test scripts (in directory t) show simple INTERCAL programs which can
be very confusing^H^H^H^H^H^H^H^Huseful to the learner. Other examples can
be found in the directory eg.

