/************************************************************************/
/**                                                                    **/
/**                   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, Imagine F compiler                          **/
/** 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  Linux version of the graphics software  DISLIN for  the Imagine F
   compiler is distributed  as a compressed  tar file with  the file name
   dislin-n.m.linux.F.tar.gz. The number 'n.m' is the current version  of
   DISLIN. 

   Note :   The free educational  version of the  PC Linux F compiler can
            be used for this DISLIN version. It is available from
            http://www.imagine1.com/imagine1.    
            

2.) Installation of the RPM Distribution

   The installtion of the RPM distribution of DISLIN for Linux Imagine F
   is very easy. Give the command

                  rpm -i  dislin-9.0.linux.F.rpm

   To uninstall DISLIN for Linux Imagine F give the command:

                  rpm -e  dislin_F 

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

           -  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.F.tar.gz

b) Restore files from the tar file with the command

                  tar   xvf   dislin-9.0.linux.F.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
                   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

   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 DISLIN examples in the
   directory $DISLIN/examples/F with the command:

                    f90link -a xxx         

   Notes: - An alternate linking method is:

            F -o xxx -I$DISLIN/F xxx.f90 -L$DISLIN -ldislin

          - f90link links by default with the DISLIN single precision
            library libdislin.so. A double precision version 
            of the library for real numbers is included in this 
            distribution (libdislin_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

