General
-------
AVL and its plot library should compile on any Unix system 
with normal Fortran-77, C, and X-Windows support. 


Build sequence
--------------

1) Build the plot library in  ./plotlib  ...

 % cd plotlib
 % make (displays current make options for system (gfortran,ifort,mingw)
 % make (system)          (creates libPlt.a)

 Or if that does not work...
 % edit Makefile and config.make for your system (set compiler flags for your system)
 % make                   (creates libPlt.a)


2) Build Eispack library in ./eispack  ...

 % cd eispack
 % make -f Makefile.xxx   (where xxx is gfortran, ifort or mingw)

 Or if that does not work...
 % edit Makefile.xxx  (set compiler flags for your system)
 % make           (creates eispack.a)

3) Build AVL in ./bin  ...
 % cd bin
 % make -f Makefile.xxx avl   (where xxx is gfortran, ifort or mingw)

 Or if that does not work...
 % edit Makefile.xxx and save as Makefile  (set compiler flags for your system)
 % make avl


The executable will appear in the bin/ directory.


Documentation
-------------
User Guide is in the  avl_doc.txt  file.  If impatient, you can just
run AVL in the runs/ directory, which contains a few input files:

 % cd runs
 % ../bin/avl vanilla

The files  session1.txt, session2.txt  contain keyboard input examples.


Graphic Notes for X-windows 
---------------------------
The plot library for X-windows does not refresh the plot windows on expose 
events (i.e. when the window is covered and then uncovered).  Proper operation
assumes that the optional X backing store is enabled.  It is not always turned
on in current (Linux, typically) X installations.  The backing store can be 
enabled by adding a line to your X configuration file (typically found in 
/etc/X11/xorg.conf).  The line should be added to the Device Section and looks
like this:
   Option "BackingStore" "True"

This shows the Device section from my xorg.conf file with the backing store 
enabled.  Note that you will have your own Identifier and Driver lines, 
just add the Option line.

Section "Device"
    Identifier  "Miserable Old SVGA"
    Driver      "miserable"
    Option	"BackingStore"	"True"
EndSection

You probably need to restart the X server before this works (try just logging 
out or rebooting).


Notes for Windows 
---------------------------
AVL can be built for Windows using either the MinGW tools or the Intel fortran
and Microsoft C compiler.  Further details on this are found in notes in the
misc directory.