/************************************************************************/
/**                                                                    **/
/**                   Linux Installation of DISLIN                     **/
/**                                                                    **/
/** Contents: 1.) Introduction                                         **/
/**           2.) Installation of Libraries and Utility Programs       **/
/**           3.) Using DISLIN from Java                               **/
/**           4.) Using DISLIN from Perl                               **/
/**           5.) Using DISLIN from Python                             **/
/**           6.) Web Sites.                                           **/
/**                                                                    **/
/** Date   : 15.11.2005                                                **/
/** Version: 9.0  / Linux                                              **/
/** Author : Helmut Michels, Tel.: +49 5556 979 334                    **/
/**          MPI fuer Sonnensystemforschung,                           **/
/**          D-37191 Katlenburg-Lindau, Germany                        **/
/** Mail:    michels@mps.mpg.de                                        **/
/************************************************************************/

1.) Introduction


   DISLIN is a high level and easy to use graphics library for displaying
   data as curves,  bar graphs,  pie charts,  3D-colour plots,  surfaces,
   contours and maps. The software is available for several C, Fortran 77
   and Fortran 90 compilers.

   Notes: - The Linux distributions of DISLIN supports programming on
            Linux with gcc, g77, g95, Imagine F, Absoft f77/f90, 
            NAG f90/f95, Intel ifc/icc, Lahey lf95, Portland Group 
            pgf77/pgf90, Java, Perl and Python. 

          - All Linux versions of DISLIN can be used freely for non-
            commercial appications. Licenses for commercial use of
            DISLIN are available from the site http://www.dislin.de.       


2.) Installation of Libraries and Utility Programs

a) Uncompress the tar.gz file with the command

                  gzip -d     dislin-9.0.tar.gz


b) Restore files from the tar file with the command

                  tar   xvf   dislin-9.0.tar

c) Change to the installation directory of DISLIN

                  cd    dislin-9.0

d) Choose a directory in the file structure where DISLIN should be
   installed and define the environment variable DISLIN with it:

   For example:    DISLIN=$HOME/dislin
                   export DISLIN


e) Run the install program with the command

                   INSTALL

   This program copies files to $DISLIN and sets protections.

f) To make DISLIN available for general use, write the following com-
   mands to your .profile or to /etc/profile

                    DISLIN=directory
                    export DISLIN
                    PATH=${PATH}:${DISLIN}/bin

                    LD_LIBRARY_PATH=$DISLIN:$LD_LIBRARY_PATH
                    export LD_LIBRARY_PATH

g) Now you can compile, link and run the example programs in the
   directory $DISLIN/examples with the commands:

                    clink   -a exa_c      (for gcc)
                    clink   -a map_c      

                    dlink   -a exa_f77    (for Fortran 77)
                    dlink   -a map_f77

                    f90link -a exa_f90    (for Fortran 90)
                    f90ink  -a map_f90

h) You can delete the installation directory 'dislin_9.0'.


3.) Using DISLIN from Java        

   An interface for the programming language Java is also included in
   the DISLIN distribution for Linux. It allows to use DISLIN routines
   from Java applications. The interface and examples can be found in 
   the directory $DISLIN/java

   To use DISLIN from Java, you have to define the  environment variable
   CLASSPATH:

             export CLASSPATH=$DISLIN/java:.
   
   The examples in $DISLIN/java can be compiled and executed with the
   commands

   javac  example.java
   java   example 


4.) Using DISLIN from Perl        

   A DISLIN module for the programming language Perl is included in this
   DISLIN distribution. The module and some examples can be found in the
   directory $DISLIN/perl

   To use DISLIN from Perl, you have to define the  environment variable
   PERL5LIB:

             export PERL5LIB=$DISLIN/perl


   Note: Source code of the Perl extension is included in the
         directory $DISLIN/perl for re-creating the module.


5.) Using DISLIN from Python        

   An extension module for the programming language Python is included
   in the directory $DISLIN/python.
   To use DISLIN from Python, you have to define the  environment variable
   PYTHONPATH:

             export PYTHONPATH=$DISLIN/python

   Note: Source code of the Python extension is included in $DISLIN/python
         for re-creating the module.


6.) Web Sites

   DISLIN is available via ftp anonymous from the following sites:

      ftp://ftp.gwdg.de/pub/grafik/dislin
      ftp://unix1.mpae.gwdg.de/pub/dislin

   The DISLIN Home Page is:

      http://www.dislin.de