CLC-INTERCAL 0.05 is a major rewrite of the Perl INTERCAL compiler. I still
consider it alpha quality, but I've redesigned some parts of the compiler
and improved other parts, and I feel confident that there'll be a beta soon.

CLC-INTERCAL is designed to be almost compatible with the original (Princeton
1972) compiler. See the POD included in Language/INTERCAL.pod for a discussion
of extensions and limitations to the language, or consult the on-line reference at

    http://www.assurdo.com/INTERNCAL/reference/

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, preferably x.xx >= 0.05) and unpack it
somewhere. Then change directory to that somewhere and type:

    perl Makefile.PL
    make
    make test
    make install

The third step might take a long time, depending on your CPU and memory speeds.
It performs about 2260 tests, checking every part of the compiler and repeating
tests up to six times to make sure you get consistent results when giving
different options to the compiler. Have a cup of coffee while it runs.

If you are running a proper operating system, you might need superusers
privileges for the last step, depending on who owns the Perl library
directory.

If any test program fails, please let me know (email to <lunatic@assurdo.com>
would be the best way). The name of the test program(s) which failed, the list
of test they reported as failed, what standard output produced, and any
information you might think relevant will be useful.

To consult the extensive documentation which comes with the compiler you can
use:

    perldoc Language::INTERCAL

Version 0.04 of the compiler used modified EBCDIC for all input (including the
source code of INTERCAL programs), but could be persuaded to use ASCII or
extended Baudot. Version 0.05 will accept input in modified EBCDIC, extended
Baudot, and ASCII, and will guess the character set used for each source file.
Output can also be in any installed character set, defaulting to ASCII.
Internally, the programs generated by the compiler will use extended Baudot.
The two non-ASCII character sets are fully documented using the commands:

    perldoc Charset::EBCDIC
    perldoc Charset::Baudot

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.

Before I stop typing and go back to extending INTERCAL even further for the
next version, I would like to thank all the people who post on the newsgroup
and the mailing list for the steady supply of ideas, insane or otherwise.

