November 10, 1992

Hello,

You are looking at the README file for the rtf-tolerant Objective-C compiler for the NeXT.  Follow these instructions closely and you should be up and compiling with rtf in a matter of minutes.

1.	Copy the cpp and cpp-precomp files to the /usr/local/bin folder.  Make this folder visible by all machines on your net.

2.	The link cpp-precomp links to cpp and is required.  Don't ask me why, it just works this way.  I have tried having one or the other and it didn't work; you must have both.  Someday I'll figure this out :-)

3.	Copy the rtf-ascii file into the same folder ( /usr/local/bin).  This utility strips out rtf from your source so the compiler can deal with ascii.  To use this standalone, type:

	/usr/local/bin/rtf-ascii < fileName

	The output goes to stdout.  You may never need to use this standalone, I only mention this for completeness.

4.	To take advantage of the new cpp, use the -B/usr/local/bin/ flag.  I put this in the preamble of my main project.  For example:

	CFLAGS = -B/usr/local/bin/

5.	Convert your source files to rtf.  I have included a sample to give you some ideas.  Be aware that .h files may need to be parsed into IB and you cannot do this once they're rtf.  Of course, grep, diff, and other unix tools are not rtf aware.

6.	The new gdb which is integrated with Edit works wonders with rtf.

7.	Currently, Help Links are not handled by the lex grammar I have, so you must comment these out.  See the example files I've included.

8.	If you're interested in the cccp.c file (the source for the preprocesor), you'll find all of the changes I made by searching for "lloyd" and or "rtfopen".

9.	Have fun!

Charles Lloyd
42 Firefall Ct.
The Woodlands, TX  77380
713/363-9001
wiltel!clloyd@uunet.uu.net