
This file contains the source for TR233 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)

In addition, these other files themselves imbed files that contain the
graphical material that appears in the various figures in the manual.
There are two 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:XXXXX.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
microsystem graphics display.  The actual raster files are named
ras:XXXXX which then need to be converted into PostScript.  This is
done by running it first through Paul Chou's raster2iff filter which
makes it into an .iff file, then through iff2ps which turns that into
the .ps file which is actually imbedded into the LaTeX source file.

Thus all figures are automatically imbedded -- no cutting or pasting
is required.  There is one little complication.  This is due to the
fact that, at this time, we do not have a single processor that can
imbed both kinds of figures described above at the same time.
The way to get around this is to run the whole document through LaTeX
to create a .dvi file and then use dviselect to split this into two
different .dvi files, one containing fig-type graphics, the other
containing the raster-type graphics.  Fortunately all the raster-type
graphics are exclusively in Chapter 4 (the Graphics Interface) which
does not contain any fig-type graphics.  Thus you only need to split
off this chapter from the rest of the document, process it using
dvialw which can then be printed directly on the Apple Laserwriters.
The balance of the document can be printed using texpr.  Then the two
pieces of the document need to be just merged.  Thus a script for
printing out the entire document on the printer Chaucer appears below.
Keep in mind that the pages ranges specified in dviselect are
appropriate only if none of the document is changed, otherwise those
ranges should be verified and changed if necessary.

# Latex the entire document -- creates tr233.dvi
latex tr233.tex

# select out pages 131 through 168 from tr233.dvi and put into giman.dvi
dviselect -itr233.dvi -ogiman.dvi 131:168

# creates a Laserwriter-ready copy of giman.dvi into giman.dvi-alw
dvialw giman.dvi

# prints the Graphics Interface reference manual on Chaucer
lpr -s Pchaucer giman.dvi-alw

# selects out the rest of the document (excluding pages 131 through 168)
dviselect -itr233.dvi -orestman.dvi 1:130,169:181

# prints the rest of the document on Chaucer
texpr -s -Pchaucer restman.dvi

