This directory contains the source for Technical Report 233, which
makes up the official documentation for the Rochester Connectionist
Simulator.  This raw source is designed to be run through LaTeX to
produce a .dvi file.  The top level file (the one that should be
"latexed") is named tr233.tex and contains the formatting information
for the entire document, the title page, the abstract, and then the
"includes" for the files that contains the actual documentation.  These
other files break the report into the following Chapters:

Chapter 1 : intro.tex (introductory material)

Chapter 2 : userman.tex (contains the User Manual for the simulator)

Chapter 3 : refman.tex (contains advanced material for the simulator)

          : impl.tex (describes implementation details of simulator)

Chapter 4 : giman.tex (contains the User Manual for the Graphics Interface)

Chapter 5 : bpman.tex (describes the back propagation package)

and, of course:

the cover page: cover.tex

In addition, these tex files themselves imbed files that contain the
graphical material that appears in the various figures in the manual.
There are three types of figures.

	The first type consists of drawings made using the "fig"
	utility.  Files containing the source for this information are
	in files named fig.*.  However these fig files must be
	converted to tex files before they can be imbedded into LaTeX
	files.  At the University of Rochester this is done by running
	the .fig file through f2p which creates a .pic file and then
	that is run through tpic to produce the final .tex file that is
	actually imbedded in the LaTeX source.

	The second type of figure originated as a raster file taken
	from a Sun Microsystems graphics display.  The actual raster
	files are named ras.* which then need to be converted into
	PostScript.  This is done running it through the University of
	Rochester's iff2ps utility.

	The third type of figure is an X11 window dumped produced by
	the "xwd" program (and named wd.*).  These were piped through
	the "xpr" utility to produce PostScript files, then hand-edited
	(yuk) to insert BoundingBox information and remove page number
	and various other conformant PostSript comments.

The dvi2ps we're using is Stephen Bechtolsheim's, and can handle
imbedded postscript figures with its "psfig" support.  The final
output files are "conformant PostScript", so you should be able to
extract ranges of pages from them with your favorite PostScript
manipulation program, such as "psrev".  In order to avoid numerous
complaints from people with early, buggy, versions of Adobe's "psrev",
though, I have inserted an extra `%!' line at the front of the
PostScript files, so that "psrev" will not try to reverse the pages
unless you remove this line.

By the way, the pages are formatted to be printed back-to-back and
then bound, so the margins are different for the odd and even numbered
pages.

-------

NOTE:  Unless you are actually revising the manual yourself, you are
probably better off just printing the enclosed PostScript files
(COVER.PS and TR233.*.PS).  It is rather unlikely that ALL of your Sun,
fig, PostScript, and TeX support tools work exactly the way ours do.

CAUTION:  At least one of the generated Postscript files is about one
Megabyte in size.  Make sure that your spooler will be willing to
accept files that large;  on Berkeley-based systems, the /etc/printcap
entry for your printer should probably include the :mx#0: (no maximum
file size) parameter.
