This directory contains the nroff source for a first draft of the paper
"A Detailed Tour Through the /6 Portable C Compiler".  The ouput from nroff
is about 500 blocks.  The document uses the ms macros with some additions.
The file tmac.s contains a full tmac.s with mods.  The normal command used
to generate a new copy is:
	tbl tour[01]* | nroff tmac.s -i
where the -i should be replaced by a '-' for those with a non-V7 nroff.
Please note that this paper is far from finished, and I reserve the right
to answer any complaints of inaccuracies or stupidities with the statement:
"but it's only a first draft".  Seriously, I would say that the first
8 chapters are solid, with later sections subject to the most scrutiny.
Many of the latter sections of the paper are filled with personal opinions,
so take them with a grain of salt.

As of 6/15 the paper was missing section 9.1 on the file order.c, some
examples from the symbol table section, and the section on performance.
The appendices are not finished, and haven't been included with this copy.
If you find the paper worth reading and want to have the finished version,
get in touch with me in another month.  By then I'm supposed to have my
thesis finished, so this paper will also be completed.  The table of
contents has been brought up to date for the version of the paper included.
So, if you want a copy of it try
	nroff -ms tour.index
The page numbers and footnotes are to be ignored, as I haven't made any
effort to keep either in a unified fashion.
To be meaningful this document should be prefaced with Steve Johnson's
"Tour Through the Portable C Compiler", found in the documentation for
Release 7 of UNIX.

I welcome comments/improvements in this document, and would like to hear
about errors found (as I'm sure there are a number of them in a paper of
this size).

This paper has been distributed in source format to allow people to use
whatever facilities they have to print it, as we only have a Printronix
line printer.  Since I haven't seen the document printed on anything other
than a Printronix, there are sure to be a number of places where bold and
italics fonts have been messed up.  I started off with the notion that I
wanted to italicize certain items, embolden others, etc. but quickly lost
the initiative when I only had underlining to work with.  I don't care about
copies being distributed within "educational institutions", so long as the
document isn't chopped up. Just be aware that much of the material discussed
is proprietary, so recepients should have a license for PCC.

		Sam Leffler
		Computer Eng. Dept.
		Crawford Hall
		Case Western Reserve Univ.
		Cleveland, Ohio 44106
		(216) 368-2800
