/************************************************************************/
/**                                                                    **/
/**                   Linux Installation of DISLIN                     **/
/**                                                                    **/
/** Contents: 1.) Introduction                                         **/
/**           2.) Installation of the RPM Distribution                 **/
/**           3.) Installation of the tar.gz Distribution              **/
/**           4.) Compiling, Linking and Running the Example Programs  **/ 
/**           5.) Getting a DISLIN License                             **/
/**           6.) Web Sites.                                           **/
/**                                                                    **/
/** Date   : 15.11.2005                                                **/
/** Version: 9.0 / Linux, Absoft F77, F90                              **/
/** Author : Helmut Michels, Tel.: +49 5556 979 334                    **/
/**          MPI fuer Sonnensystemforschung, Max-Planck-Str. 2,        **/
/**          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.

   The UNIX versions of the graphics software  DISLIN  are distributed as 
   compressed tar files with the file names 'dislin-n.m.xxx.tar.gz' where
   'n.m' contains the DISLIN version while the part 'xxx'  identifies the 
   operating system or compiler.  


2.) Installation of the RPM Distribution

   The installtion of the RPM distribution of DISLIN for Linux/Absoft is
   very easy. Give the command

                  rpm -i  dislin-9.0.linux.af.rpm

   To uninstall DISLIN for Linux/Absoft give the command:

                  rpm -e  dislin_af 

   Notes:  -  You must be root to install the RPM distribution of DISLIN
              for Linux/Absoft.

           -  The RPM package 'dislin' is required.


3.) Installation of the tar.gz Distribution

a) Uncompress the tar.gz file with the command

                  gzip -d     dislin-9.0.linux.af.tar.gz

b) Restore files from the tar file with the command

                  tar   xvf   dislin-9.0.linux.af.tar    

c) Change to the extraction 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    (or: DISLIN=/usr/local/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=/usr/X11R6/lib:$DISLIN
                    export LD_LIBRARY_PATH

   Note: The environment variable DISLIN is not necessary if DISLIN
         is installed in the default directory '/usr/local/dislin'. 

g) You can delete the directory 'dislin-9.0'.


4.) Compiling, Linking and Running the Example Programs

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

                    af77link  -a exa_f77    (for Absoft F77)       
                    af90link  -a exa_f90    (for Absoft F90)
   and
                    af77link  -a map_f77    (for Absoft F77)
                    af90link  -a map_f90    (for Absoft F90)       

   Notes: - If your compiler version does not recognize the format of
            the DISLIN module file 'DISLIN.mod' in the DISLIN directory, 
            the file 'dislin.f90' must be re-compiled with your compiler   
            version (i.e. f90 -c dislin.f90).

          - af77link and af90link link by default with the DISLIN single 
            precision libraries libdisaf77.so and libdisaf90.so.
            Double precision versions of the libraries for real numbers are
            included in this distribution. They have the names 
            libdisaf77_d.so and libdisaf90_d.so.


5.) Getting a DISLIN License

   DISLIN is free for non-commercial use. Licenses for selling programs
   linked with DISLIN or for using DISLIN in an environment related to
   business are available from the site http://www.dislin.de. 


6.) Web Sites

   DISLIN is available via ftp anonymous from the following site:

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

   The DISLIN home page is:

      http://www.dislin.de
