This directory contains the source and executable for my lc program,
which supplies the much needed UNIX-like command line interface to the
Lattice C compiler for the Amiga.

	This program differs from previous PD "cc" programs in that it somewhat
cleverly strips verbose, redundant messages off of the output of the
different parts of the compiler system.  I read that at least one other
person hated these messages as much as I did, so I guess throwing this
program into PD is justifiable.

USE OF THE PROGRAM

	First, read and follow the instructions provided in the file called
INSTALLATION.  You can, of course, leave your present system in place
while trying this program out to see if you like it.  For example, you
can put the directory structure described on its own floppy in df1:
and "assign lc: df1:"  There is absolutely no need to commit to
using this program if you already have a system that you are used to using.

	My lc program works much like the LC provided by Lattice in release 3.03,
except that it accepts C source files (with .c extension), assembler source
files (.a extension) and object files (.o extension), and generally works
in a more sophisticated manner.

	To compile a simple C source file (e.g., filename.c), just type,
	
	cc filename.c

	If your program is in separate modules, you can compile them separately
	into object files using the -C option, then compile these together, like,

	cc filename.o aux1.o aux2.o ...

	or just compile all the C source files together, like,

	cc filename.c aux1.c aux2.c ...

	(You can mix .c, .o and .a (assembly source) files, and options
	for the various stages of compilation/assembly/linking on the command
	line in any way you wish; lc will figure out what to do with them.)

	lc would then produce a file called filename (derived from the first
	named file in the argument list) in the current directory,
	which would be executable.  In the true UNIX spirit, lc normally runs
	without any output to the console as long as there are no problems.

OPTIONS

	With a few exceptions, described in lc.doc, the options are identical
	with those described in the Lattice C manual.
    Note that options must be separated; use "cc -P -C", not "cc -PC".

CAUTIONS / ADDITIONAL NOTES

	Don't try to compile the source with the Manx compiler; the function
strncpy is used, which differs in a significant way between Lattice
and Manx.

	A makefile is provided for compiling with the Lattice compiler.  Oddly,
the makefile has only been tested with Manx's make program; I don't have
the Lattice Make Utility.

Note that this program is not for compiling stand-alone assembly programs,
which  requires loading libraries in a different order.

The code is fairly simple, and if you know enough C to have a need for it,
you can certainly fix it up for your own needs.  That's what you get the
source for!

Jay Ts
Box 890
West Oneonta NY 13861
607/432-4836

This program, both executable and sources, are Copyright 1986, Jay Ts.
You may copy, distribute, alter, and use them, but absolutely no permission
is granted to remove copyright notices from them or distribute them,
in whole or in part, as, or as part of, a commercial product.