********************************************************************
**                                                                **
**               IBM-PC Installation of DISLIN                    **
**                                                                **
**  Contents:  1.)  Introduction                                  **
**             2.)  Installation of DISLIN                        **
**             3.)  Using DISLIN from Perl                        **
**             4.)  Using DISLIN from Python                      **
**                                                                **
**  Date   :   01.10.2002                                         **
**  Version:   8.0   /  Windows, Cygwin, G77/GCC/Perl/Python      **     
**  Author :   Helmut Michels, Tel.: +49 5556 979 334             ** 
**             MPI fuer Aeronomie, Max-Planck-Str. 2,             **
**             D-37191 Katlenburg-Lindau, Germany                 **
**             E-mail: michels@linmpi.mpg.de                      **
********************************************************************

1.)  Introduction

     This file describes the  installation  of the  data  plotting
     software DISLIN on IBM-PCs  for  the operating system Windows
     9x/NT/2000/XP and the Cygwin compilers GCC and G77.

     Notes: 

       - This version of DISLIN for Cygwin is free software. You can
         copy  and redistribute it. 

       - A free version of Cygwin is available from

         http://sourceware.cygnus.com/cygwin

       - EGCS (GCC+G77) for Cygwin is available from

         http://www.xraylith.wisc.edu/~khan/software/gnu-win32


2.)  Installation of DISLIN

     The  DISLIN version for the Cygwin compilers  GCC and G77  is
     distributed in the zipped file  dl_80_gc.zip.  An utility for
     unpacking the DISLIN files is available from the same locati-
     on where you have downloaded dl_80_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_80_gc.zip
     and unzip.exe to it:

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

  b) Extract the DISLIN files with the command:

                 unzip  -o dl_80_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

     Add the DISLIN\WIN directory to the PATH environment in the 
     file AUTOEXEC.BAT

     for example:  PATH C:\BIN;C:\DISLIN\WIN

     Add the DISLIN environment variable DISLIN to the autoexec.bat
     file:

     for example:  SET DISLIN=c:\dislin   
   

  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)

                    clink  -a  map_c       (for gcc)
                    dlink  -a  map_g77     (for g77)

     Note: Normally,  the linker  of GCC creates  a Windows  console 
           program.  This means  that a console is created automati-
           cally  by the  operating system  for  using  standard I/O 
           functions such as printf and scanf.  You can suppress the
           console  window by using the switch  '-mwindows'  in gcc.
           In this case,  you can manage I/O with  the DISLIN widget
           routines  and you  should  use  the statement
           'winapp ("windows");' before 'disini',  which  means that  
           DISLIN warnings are written to a file and that the proto-
           col in disfin is displayed in a widget.


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.6.1 and
             Cygwin 1.3.9-1.

           - The source code of the DISLIN Perl module is included
             in the file dl_80_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.2 
             and Cygwin 1.3.9-1.

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


