%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%       README file for SNNSv4.0 User Manual
% 
%       10.05.95        Guenter Mamier
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

This directory should contain the following files and directories
(marked with a '\'):

Extensions.tex          tex file containing all the sections that have been 
                        added to the Manual since the last release
Implementation.tex      main file for all the chapters that deal with 
                        implementation issues
README                  this file
UserManual.bib          user manual bibliography
UserManual.ind          user manual index file
UserManual.tex          user manual (main file, it includes all other
                        files files which make up the documentation)
batch_example.tex       example batch protocol file
batch_version.tex       batch version manual
file_examples.tex       SNNS network file examples
file_interface.tex      SNNS network file interface description
grammar.tex             SNNS network file grammar
intro_SNNS.tex          introduction to SNNS
kernel_design.tex       kernel overview
kernel_func_ui.tex      kernel function interface
kernel_implem.tex       kernel implementation
kernel_struct.tex       kernel internal data structures
licensing.tex           SNNS license agreement (part of the manual)
network_creation.tex    xgui bignet tool to help create big networks
nn_analyzing.tex        analyze tools
nn_models.tex           explanation of the implemented models and functions
nn_terminology.tex      introduction to connectionism and terminology
rpc_version.tex         description of the distributed version.
title.tex               title page of this report
trans_funcs.tex         kernel activation functions, output f.s etc.
using_xgui.tex          xgui usage
xgui_3D.tex             xgui 3D display manual chapter
xgui_3D_implem.tex      xgui 3D implementation
xgui_editor.tex         xgui 2D display editor commands
xgui_implem.tex         xgui implementation (2D)
LaTeX_styles/           LaTeX styles directory which you might need 
                        at your site to run the manual through LaTeX
intro_figs/             all Postscript figures of the intro chapters
kernel_figs/            all Postscript figures of the kernel chapters
nn_models/              all Postscript figures of the nn_models chapter
xgui_3D_figs/           all Postscript figures of the xgui 3D display
xgui_bignet/            all Postscript figures of the xgui bignet tool
xgui_figs/              all Postscript figures of the 2D user interface



%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
        How to print the user manual with LaTeX
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

If you want to generate a complete user manual type 
        make UserManual.ps
to generate only the extensions type
        make Extensions.ps
to generate the implementation manual type
        make Implementation.ps

These calls will generate the postscript files for the corresponding
documents. Afterwards you can type 
        make clean 
to remove all the temporary files created by latex.

The   resulting   files `UserManual.ps`,  resp.    `Extensions.ps`  or
`Implementation.ps`, should print on  any PostScript laser printer. We
mostly use  Apple LaserWriter  printers at  our site,  but it has also
been tested on other laser printers.

        lpr UserManual.ps       <options to indicate Postscript file>

At our site printing over the network is done with a non-standard
printing routine, so we have to include an option '-raw' to tell the
printer that it is a Postscript file. This varies from site to site.

4) Some printers don't handle files larger than 1MB. Since the manual 
is about 9MB big, it is advisable to split it up before printing. This 
can be done f.e. with

        dvips UserManual.dvi -l 50 -o part1.ps
        dvips UserManual.dvi -p 51 -l 100 -o part2.ps
        dvips UserManual.dvi -p 101 -l 150 -o part3.ps
        dvips UserManual.dvi -p 151 -l 200 -o part4.ps
        dvips UserManual.dvi -p 201  -o part5.ps


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
        How to print the user manual from the Postscript file
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

You can also obtain a Postscript file of the SNNSv4.0 user manual from
us. It can be fetched from the same ftp directory as the original
SNNSv4.0 software under the name

        SNNSv4.0.Manual.ps.Z

It is a compressed Postscript file (~ 1.5 Mb) of the documentation with
all figures included. It is identical to the above file `UserManual.ps`
and can be printed directly after uncompressing it.


%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
        End of this README file
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%