******************************************************************
**                                                              **
**               IBM PC Installation of DISLIN                  **
**                                                              **
**  Contents:  1.)  Introduction                                **
**             2.)  Check the Contents of the Disk              **
**             3.)  Installation of DISLIN                      **
**             4.)  Minimum Set of DJGPP .zip Files             **
**             5.)  Using Super VGA Cards                       **
**                                                              **
**  Date   :   30.11.1996                                       **
**  Version:   6.3   /  G77 and F2C for DJGPP v2.0              **
**  Author :   Helmut Michels, Tel.: +49 5556 979 334           ** 
**             MPI fuer Aeronomie, Postfach 20,                 **
**             D-37189 Katlenburg-Lindau, Germany               **
**             E-mail: michels@linax1.mpae.gwdg.de              **
******************************************************************

1.)  Introduction

     This file describes the installation of the graphics software
     DISLIN on  IBM PCs  for the operating system  MS-DOS  and the  
     GNU Fortran compiler G77 0.518 and the Fortran to C converter
     F2C that can be used with DJGPP v2.0.


     Notes: - Binaries of F2C for DJGPP can be found on
              ftp://shiho.tokyo-u-fish.ac.jp
       
            - Binaries of G77 for DJGPP can be found on
              http://users.hol.gr/~kkou

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


2.)  Check the Contents of the Disk

     The DISLIN distribution disk contains the following files:

     README.INF
     DISLIN.INF
     DL_G7_63.ZIP 
     UNZIP.EXE

3.)  Installation of DISLIN

     The PC version of the graphics software DISLIN for G77/F2C is
     distributed as a .zip  file  created  with the file packaging
     utility ZIP (version 1.9). The .zip  file  has the  file name
     DL_G7_nn.ZIP where nn is the current version number of DISLIN.

     To install DISLIN, make the following steps:

  a) Create a temporary directory and copy all files from the
     distribution disk to the directory:

     for example:   md  c:\temp
                    cd  c:\temp
                    copy a:\*.*  *.*

  b) Extract DISLIN files with the command:

                    unzip -o DL_G7_63

  c) Run the install program with the command

                    INSTALL c:   (or INSTALL d:)

     The program INSTALL installs DISLIN in the directory c:\DISLIN
     (or d:\DISLIN).

  d) Reconfigure the System

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

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

   - 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 program  in the
     directory \dislin with the command

                    dlink  -a  example    (for G77)
             or
                  f2clink  -a  example    (for F2C)

4.)  Minimum Set of DJGPP .zip Files

     The following DJGPP .zip files are the minimum set of files
     for compiling and running DISLIN programs:

     djdev201.zip
     bnu27b.zip
     gcc272b.zip
     grx20.zip

5.)  Using Super VGA Cards
     
  a) If the environment variable GRX20DRV is defined, DISLIN uses the
     GRX20 library to display graphics on the screen.

     For example: set GRX20DRV=et4000 gw 1024 gh 768 nc 256

     This method is fast and should be used for Super VGA cards.    

  b) If the environment variable GRX20DRV is not defined, DISLIN uses BIOS
     calls to display graphics on the screen.  Special graphic modes can
     be defined with the utility program  DISVID (see DISVID).

     This method is slow and can be used if method a) is not available.


  Notes: 

  -  Elementary image routines such as rtiff, rimage and wpixls can only
     be used with method a) and with a full colour mode (nc 256 in GRX20DRV).

