---------------------------------------
ISVis:  Interaction Scenario Visualizer
---------------------------------------

VERSION: 1.1

   DATE: Dec 30, 1998


List of Files
-------------

     COPYRIGHT
     README
     bin/
		isvis
		isvis_tracelib.o
		isv_instr
		sbfilesin
		sbstatic
     doc/
		isvis_userguide.html
		isvis_logo.jpeg
		isvis.gif
		main_big.gif
		scenario_big.gif
     etc/
                isvis.coll
                isvis.emap

     include/
		event_writer.H
     src/
		Makefile
                Makefile.acme
                Makefile.noacme	
                acmeinterfaceclass.H
                actor.H
		actor_list_view.H
		disk_file.H
		event.H
		event_reader.H
		global_state.H
		hash.H
		instrumentor.H
		interaction.H
		io_shell.H
		main_view.H
		mural.H
                node.H
		program_model.H
		scenario.H
		scenario_view.H
		static_analyzer.H
		static_info.H
		trace.H
		trace_analyzer.H
                vector.H
		view.H
		view_manager.H
		xapp.H
		actor.C
		actor_list_view.C
	        acmeinterfaceclass.C	
                disk_file.C
		event.C
		event_reader.C
		event_writer.C
		hash.C
		instrumentor.C
		interaction.C
		io_shell.C
		main_view.C
		mural.C
                node.C
		program_model.C
		scenario.C
		scenario_view.C
		static_analyzer.C
		static_info.C
		trace.C
		trace_analyzer.C
                vector.C
		view.C
		view_manager.C
		xapp.C
	/tutorial
		boxscen1.jpg
		dfs.staticinfo
		dfs.trace
		dfs.traceinfo
		isvis_tut.html
		isvis_tut2.html
		isvis_tut3.html
		isvis_tut4.html
		mainscr1.jpg
		scenv.jpg
	/tutorial/Polka
		{source files for use in tutorial}



Installation
------------

Platform Requirements:  Solaris2.5+, SunOS 4.1.x, IRIX 5.2+
			X11R5
			Motif 1.1+
			RogueWave tools.h++

1) obtain the compressed ISVis tar file

2) create a home directory for ISVis on your system

3) place the compressed ISVis tar file in the directory from (2)

4) uncompress the ISVis tar file:
	uncompress <isvis tar file>

5) extract the tar archive:
	tar xvf <isvis tar file> 
   This should create the subdirectories /bin, /include, and /src
   containing the files listed above.  (Note that /bin/isvis and
   /bin/isvis_tracelib.o are not created until compilation)

5a) To build, decide whether to you want ACME export or not.  If you want
    ACME, then download and install ACMEServer first.  Copy Makefile.acme to 
    Makefile (cp Makefile.acme Makefile).  If you do not want ACME, then
    simply copy Makefile.noacme to Makefile (cp Makefile.noacme Makefile).

6) edit the /src/Makefile as follows:
   a) change the ISVIS_HOME variable to reflect the directory in (2)
      change the ACME_HOME variable to show the location of acmeserver install
   b) uncomment the appropriate OS dependent flags for your OS, and
      make any modifications to the compiler, X Windows, and Motif
      include and library paths as appropriate
   c) make sure the OS dependent flags for other OS's are commented out
      using a pound sign (#)

7) cd to the /src directory and type
	make depend
   (ignore any strange messages resulting from the RogueWave tools.h++.
    Specifically, this step may issue control characters to your screen.)


8) compile ISVis by typing
	make
   This will create the executable bin/isvis and the tracing library 
   bin/isvis_tracelib.o
   (You will see a large number of warning messages. These are an
    artifact of interfacing with RogueWave tools.h++ and are expected.)

9) add the ISVis bin directory to your shell path



Documentation
-------------

HTML user guide is included as doc/isvis_userguide.html.  


Tutorial
--------

Check out the ISVis tutorial by Bob Waters, starting with 
tutorial/isvis_tut.html.


Contact Info
------------

Bug Reporting
isvis-bugs@cc.gatech.edu

General Morale Tool Support
morale_support@cc.gatech.edu


Known Bugs
----------

MAJOR:
*******************************************************************************
*******************************************************************************
MINOR:
If incorrect filename given to open a session file, no feedback is
given that file not found or file failed to open.
*******************************************************************************
*******************************************************************************