**********************************************************************
	SNNS Version 3.2 Installation 
**********************************************************************

Note that  SNNS has not been tested extensively  in different computer
environments and is a research tool with frequent substantial changes.
It should be obvious that we don't guarantee anything. We are also not
staffed to answer problems with SNNS or to fix bugs quickly.

SNNS  currently runs on colour or black and white Sun-3, Sun-4 (SPARC)
systems  under  SunOS 4.1.1  with X-Windows  X11R4 and  X11R5  (Athena
widget set,  twm, MIT  fonts etc.)  and under Sun  OpenWindows 3.0. It
also  runs  on DecStations  with MIPS R3000  Processor with  X-Windows
X11R4 and  X11R5. It has not been tested on out of the box DecStations
with DecWindows. It has also been tested recently on  the  IBM RS 6000
with AIX version  3.2. In general, the SNNS kernel will run  on almost
any  Unix  system, while  the  graphical  user  interface  might  give
problems with systems which are not fully X11R4 (or X11R5) compatible.

To build SNNS  in the  directory in which  you have moved it you first
have  to generate  the correct Makefiles for your machine architecture
and window system used. To do this, simply call the shell script

	configure

This prompts you for information  about  the  machine architecture and
the  window system  and  builds  all  necessary  makefiles  with  this
information. It uses templates found in  the  directory  configuration
for  this task. At the end of this script,  you will be told about the
next step to build the simulator.

The next step to build the simulator is  usually  to build  the kernel,
the tools and the graphical user interface with the command

        build all

or with the three commands

        build kernel
        build xgui
        build tools

This script descends into the appropriate subdirectories and calls the
makefiles  in  these  subdirectoires  to  compile all necessary source
files  and link  the  object  files  into  one  executable  file.  The
executable is located in

        <SNNS-dir.>/xgui/bin/<architecture>/xgui

where <SNNS-dir.> is the current  SNNS directory and <architecture> is
the machine architecure, e.g.  sun3, sparc, dec, rs6000, hp9000, 
pc386, or others.

We  usually  build  a symbolic link  named  'snns'  to  point to  this
executable if we often work on the same machine architecture.

        ln -s  xgui/bin/<architecture>/xgui  snns

This link  may also  be  placed in the  user home  directory (with the
proper path prefix to SNNS) or in a directory of binaries in the local
users' search path.

The simulator is then called simply with
 
        snns
 
For  further details about calling the simulator  and working with the
graphical user interface see the user manual.

**********************************************************************
	End of document 'SNNS Version 3.2 Installation'
**********************************************************************
