/************************************************************************/
/**                                                                    **/
/**                   Linux Installation of DISLIN                     **/
/**                                                                    **/
/** Contents: 1.) Introduction                                         **/
/**           2.) Installing the RPM distribution of DISLIN            **/
/**           3.) Installation of Libraries and Utility Programs       **/
/**           4.) Installation of Plot Devices                         **/
/**           5.) Using DISLIN from Perl                               **/
/**           6.) Using DISLIN from Python                             **/
/**           7.) Using DISLIN from Java                               **/
/**           8.) Web Sites.                                           **/
/**                                                                    **/
/** Date   : 15.05.2001                                                **/
/** Version: 7.5    / Linux, gcc + g77 + f2c                           **/
/** Author : Helmut Michels, Tel.: +49 5556 979 334                    **/
/**          MPI fuer Aeronomie, Max-Planck-Str. 2,                    **/
/**          D-37191 Katlenburg-Lindau, Germany                        **/
/** Mail:    michels@linmpi.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.  

   Notes: - This distribution of DISLIN supports programming on Linux
            with gcc, g77, f2c, Perl, Python and Java. 

          - All Linux versions of DISLIN can be used freely.


2.) The installtion of the RPM distribution of DISLIN for Linux is
   very easy. Give the command

                  rpm -i  dislin-7.5.linux.rpm

   This installs DISLIN in the directory '/usr/local/dislin'. The DISLIN
   utilities are copied to '/usr/bin' and links to the DISLIN libraries
   are created in '/usr/lib'.

   To uninstall DISLIN give the command:

                  rpm -e  dislin 

   Notes:  -  You must be root to install the RPM distribution of DISLIN.

           -  It's not necessary to define the environment variable
              DISLIN, or to change the PATH and LD_LIBRARY_PATH 
              environments for the RPM distribution of DISLIN.


3.) Installation of Libraries and Utility Programs

a) Uncompress the tar.gz file with the command

                  gzip -d     dislin-7.5.linux.tar.gz


b) Restore files from the tar file with the command

                  tar   xvf   dislin-7.5.linux.tar    

c) Change to the installation directory of DISLIN

                  cd    dislin-7.5

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: /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=$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) Now you can compile, link and run the example programs in the
   directory $DISLIN/examples with the commands:

                    clink   -a exa_c      (for gcc)       
                    dlink   -a exa_f77    (for g77)
                    f2clink -a exa_f77    (for f2c)
   and
                    clink   -a map_c      (for gcc)       
                    dlink   -a map_f77    (for g77)
                    f2clink -a map_f77    (for f2c)


   Note: An alternate linking method is:

       gcc -o exa_c   exa_c.o   -L$DISLIN -ldislnc -lm           (for gcc)
       gcc -o exa_f77 exa_f77.o -L$DISLIN -ldislin -lm -lf2c     (for f2c)
       g77 -o exa_f77 exa_f77.o -L$DISLIN -ldislin               (for g77)

       The -L option can be omitted if links to the DISLIN libraries
       are created in /usr/lib:

         ln -s $DISLIN/lib/dislin-7.5.so  libdislin.so.7
         ln -s libdislin.so.7             libdislin.so

         ln -s $DISLIN/lib/dislnc-7.5.so  libdislnc.so.7
         ln -s libdislnc.so.7             libdislnc.so

         ln -s $DISLIN/lib/dislin-7.5.a   libdislin.a 
         ln -s $DISLIN/lib/dislnc-7.5.a   libdislnc.a 


h) You can delete the installation directory 'dislin-7.5'.


4.) Installation of Plot Devices

   The driver program disdrv and the subroutine symfil can be used to send
   a plotfile created by DISLIN to a device.  You have to modify  the file 
   device.dat in the DISLIN directory to define a device (see device.dat).
   For example, if you have a PostScript printer with the queuename  xxxx,
   you can insert the following statements into the file device.dat:

   --------------------------
   PSC1
   POST
   lpr -Pxxxx %
   lpr -Pxxxx %
   --------------------------


5.) 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 module is included in $DISLIN/perl for
         re-creating the module.


6.) Using DISLIN from Python        

   An extension module for the programming language Python is also included
   in  DISLIN for Linux. The module and examples can be found 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.


7.) 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 

   Note:  The shareable library disjava-7.5.so in the directory $DISLIN/java
          is created with Java version 1.1.3. The source code of the Java 
          interface is included in $DISLIN/java for re-creating the interface. 


8.) 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
