************** Installing Visual Yacc *************************

Installing this software should be straightforward.
First, you need to edit the first five definitions in the
Makefile to tailor this to your system.
Typing 'make' will build and install the software.
To see if it is working correctly, go down into any of the directories
in the Examples directory.  Build the visualizer by typing
'../../visual_yacc name' where name corresponds to the name of the
lex/yacc files.  When the name.out file is created, run it
with one of the provided input files.

I've tested this install on several systems but let me know if you
have any problems.  


************** Using Visual Yacc *************************

I have no formal users guide; however, if you follow a few simple
guidelines, things appear to work as intended.  The input must
be correct lex and yacc with the exception of the use of a
single VYint designation in your union for a value that you
want shown on the stack.  For example, any union that looks like:

%union {
  . . .
  VYint myval;
  . . .
}

with just about anything in the ... regions is fine.  I haven't tested
this on multiple items to be visualized -- this can be done in the
underlying framework but the preprocessor doesn't handle this yet.
If you need multiple values, I can describe how it can be done
(if you don't mind a slightly unwieldy syntax).

I've run this software on many different inputs; however, given that
I generated most of them myself and I have a certain programming
style, I may not have handled all possible inputs.  If you have problems
with getting a particular input to work, please send me both the lex
and yacc, along with a description of what doesn't work.  My response
may not be immediate, but I will look at it.

Enjoy. Please keep me posted on how you are using this software and
what the feedback is from the users.

Thanks,

Liz White
white@cs.gmu.edu 

