********************************************************************
**                                                                **
**               IBM-PC Installation of DISLIN                    **
**                                                                **
**  Contents:  1.)  Introduction                                  **
**             2.)  Installation of DISLIN                        **
**             3.)  Using DISLIN from Perl                        **
**             4.)  Using DISLIN from Python                      **
**             5.)  Getting DISLIN Support                        **
**                                                                **
**  Date   :   15.03.2022                                         **
**  Version:   11.5 / Windows, Cygwin, gcc/g++/g95/gfortran/Perl/ **
**                                                         Python **     
**  Author :   Helmut Michels                                     **
**             Dislin Software                                    **
**             Am Hachweg 10                                      **
**             37083 Göttingen, Germany                           **
**  Email  :   michels@dislin.de                                  **
********************************************************************

1.)  Introduction

     This file describes the  installation  of the  data  plotting
     software DISLIN on IBM-PCs  for Windows and the Cygwin compi-
     lers gcc, g++, g95 and gfortran.


2.)  Installation of DISLIN

     The  DISLIN version for the Cygwin compilers GCC, G77 and G95 is  
     distributed in the zipped file  dl_11_gc.zip.  A utility for
     unpacking the DISLIN files is available from the same location
     where you have downloaded dl_11_gc.zip, or from the DISLIN CD-ROM. 

     To install DISLIN, make the following steps:

  a) Create a temporary directory and copy the files dl_11_gc.zip
     and unzip.exe to it:

     for example:   md  c:\temp
                    cd  c:\temp
                    copy e:\dislin\windows\unzip.exe    *.*
                    copy e:\dislin\windows\dl_11_gc.zip *.*

  b) Extract the DISLIN files with the command:

                 unzip  -o dl_11_gc.zip

  c) Run the setup program with the command

                  setup

     -  Choose OK

     -  Give the Installation Directory where  DISLIN  should be in-
        stalled. The default directory is C:\DISLIN.

  d) Reconfigure the System

     Set the DISLIN environment variable to c:\dislin and include
     c:\dislin\win in your path. If you have installed DISLIN in a
     different directory, you have to use that directory for the 
     environment variables above.

     The environment variables can be set or modified with the Control
     Panel 
    
     (see Control Panel -> System -> Advanced -> Environment
      Variables).

  e) Now you can compile,  link and run the example programs in the
     DISLIN subdirectory examples with the commands

                    clink   -a  exa_c       (for gcc)
                    dlink   -a  exa_g77     (for g77)
                    g95link -a  exa_f90     (for g95)

                    clink   -a  map_c       (for gcc)
                    dlink   -a  map_f77     (for g77)
                    g95link -a  map_f90     (for g95)

     Notes:

         - clink, dlink and g95link link by default with the single
           precision library discyg.a. A double precision version
           of the library is also included (discyg_d.a).

        -  If the pre-compiled DISLIN Fortran 90 module file 
           'dislin.mod' is not compatible to your g95 compiler ver-
           sion, you have to recompile the file 'dislin.f90' in the 
           DISLIN\g95 directory with the command 'g95 -c dislin.f90'.

 
3.) 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 perl subdirectory of the DISLIN directory.

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

    for example:  export PERL5LIB=/cygdrive/c/dislin/perl

    Notes: - The Perl module is created with Perl version 5.8.10.

           - The source code of the DISLIN Perl module is included
             in the file dl_11_pl.tgz in the perl subdirectory of 
             the DISLIN directory for recompiling the module.


4.) Using DISLIN from Python

    A DISLIN module for the programming language Python is also in-
    cluded the DISLIN distribution for Cygwin.  The module and some
    examples can be found in the python subdirectory of the  DISLIN
    directory.

    To use  DISLIN  from Python, you have to define the environment 
    variable PYTHONPATH

    for example:  export PYTHONPATH=/cygdrive/c/dislin/python

    Notes: - The Python module is created with Python version 2.5.2. 

           - The source code of the DISLIN Python module is included
             in the file dl_11_py.tgz in the python subdirectory of
             the DISLIN directory for recompiling the module.


5.)  Getting DISLIN Support

     The DISLIN distributions can be used freely without any restriction.
     Access to the source code is availabe via a support contract from the
     site www.dislin.de.


