LCC Port for the CESC16 Architecture

Building the compiler

1. Choose the destination directory for the binaries, and add it to the your console's rc file (.bashrc or equivalent):
   • Add the following line to your file: export LCCDIR=~/lcc. Then restart the terminal.
   • I recommend ~/lcc, but other directories can also be used, as long as they don't require root permissions.
2. Create the destination directory: mkdir $LCCDIR.
3. Make sure that all .md files use LF line termination instead of CLRF. Git will sometimes convert all line endings to CLRF automatically.
4. Run make all. The compiler should finish without warnings or errors.
5. (Recommended) Create an alias (add to .bashrc or equivalent): alias lcc="$LCCDIR/lcc".
6. (Recommended) Copy the custom headers to the destination directory: cp -rT include $LCCDIR/include.
7. (Optional) Update the manfiles sudo cp doc/*.1 /usr/local/man/man1 (you may need to sudo mkdir /usr/local/man/man1 first).

Some possible errors:

• Several errors like line 1: invalid character '%': Make sure that all .md files use LF line termination.
• Errors when compiling gram.c: Make sure it's not been automatically overwritten. Download lburg/gram.c again from GitHub if needed.

Using the compiler

Once the alias has been created, lcc can be executed just by typing lcc. Using lcc is similar to using gcc, and you can learn about the supported options by executing lcc without arguments.

It should be noted that, on the CESC16 architecture, all data types (char, int, ...) are exactly the same size (16 bits).

Original README from the LCC repository

This hierarchy is the distribution for lcc version 4.2.

lcc version 3.x is described in the book "A Retargetable C Compiler:
Design and Implementation" (Addison-Wesley, 1995, ISBN 0-8053-1670-1).
There are significant differences between 3.x and 4.x, most notably in
the intermediate code. For details, see
http://storage.webhop.net/documents/interface4.pdf.

VERSION 4.2 IS INCOMPATIBLE WITH EARLIER VERSIONS OF LCC. DO NOT
UNLOAD THIS DISTRIBUTION ON TOP OF A 3.X DISTRIBUTION.

LOG describes the changes since the last release.

CPYRIGHT describes the conditions under you can use, copy, modify, and
distribute lcc or works derived from lcc.

doc/install.html is an HTML file that gives a complete description of
the distribution and installation instructions.

Chris Fraser / [email protected]
David Hanson / [email protected]
$Revision$ $Date$