iMAM/VRS - The interactive MAM/VRS
==================================

Requirements
------------
    iMAM/VRS requires Tcl/Tk version 8.x and [incr Tcl/Tk] version 3.x.

    Caution:
       iMAM/VRS won't work if MAM/VRS has been configured with 
       with plain Tcl/Tk or [incr Tcl] versions minor to 3.0.
       If your are not sure, download the newest release from
       the scriptics web site at http://www.scriptics.com


Installation for Unix/X11 systems
---------------------------------

    1) iMAM/VRS is configured along with the MAM/VRS C++ library. 
       So, ensure that you have Tcl/Tk installed when you run
       the configuration for MAM/VRS. 

       If the auto configuration should not detect your Tcl/Tk 
       library, you can specify explicitly the paths to their
       location with: 
       ./configure --with-tcl-config=/a/weird/path 
                   --with-tk-config=/a/weird/path
 
       where the path is the directory where the 'tclConfig.sh' resp. 
       the 'tkConfig.sh' files reside. Usually the two paths are 
       the same. The location of the 'itclConfig.sh' is assumed to be 
       the same as the location of 'tclConfig.sh' because the 
       'itclConfig.sh' assumes the [incr Tcl/Tk] headers to be located
       in the same directory as the Tcl headers are.

    2) a) To compile imamvrs, change your directory to the imam add-on 
          package. 

       c) Compile iMAM/VRS:

           gmake

          When you type 'gmake' in the MAM directory, all add-ons
          (like iMAM/VRS) are made, too, running 'gmake' in the specific
          subdirectory of the 'add-on' directory of MAM/VRS. You can also
          run 'gmake' in the 'imam' directory, but be sure that MAM is made
          first.

       As the itcl.h header file itself includes tclInt.h which is
       located in the 'generic' subdirectory of the Tcl building
       directory, it's necessary to have the Tcl building directory
       (that is the 'tcl8.x' subdirectory in the Tcl package). 
   
       Be sure that the 'itclsh' and 'itkwish' of the [incr Tcl] 3.x
       package are available in your shell. 
       If you use a version minor to 3.0, the generator process will not
       work properly. 

       WARNING: The generator scripts in imam/bin use the contents of
                ITCLSH/ITKWISH if those variables are set!!!

    
    You find the executable 'imamwish' and the library 'libimam.so'
    in the subdirectories named according to your system architecture 
    (for example, mips-sgi-irix6.3) of the 'bin' and 'lib' directory.

    3) To run 'imamwish' or to dynamically load 'libimam.so' to your
       [incr Tcl] interpreter, you have to set the environment
       variables CONFIG and IMAM_LIBRARY, for example

      export CONFIG=mips-sgi-irix6.3
    or something like this:
      export CONFIG=sparc-sun-solaris

      export IMAM_LIBRARY=/some/where/mam/add-on/imam/library
    or something like this:
      export IMAM_LIBRARY=/usr/local/lib/imam 
  
    You may want to install those files to an appropriate place like
    /usr/local or something like that. You may specify that by running
    'configure' in the MAM/VRS directory using the option
    '--prefix=<path>' where <path> is the location you want to install
    iMAM/VRS. Install the files by typing 'gmake install'.

    For more information type 'gmake help'.
