******************************************************************
**                                                              **
**               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.)  Programming in Fortran                      **
**             6.)  Using Super VGA Cards                       **
**                                                              **
**  Date   :   30.11.1996                                       **
**  Version:   6.3   /   GNU-GCC 2.7.2 (from DJ Delorie, 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 compiler GCC 2.7.2

     Note:  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_DJ_63.ZIP 
     UNZIP.EXE

3.)  Installation of DISLIN

     The PC version of the graphics software DISLIN for GNU-GCC is
     distributed as a .zip  file  created  with the file packaging
     utility ZIP (version 1.9). The .zip  file  has the  file name
     DL_DJ_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_DJ_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   

   - Add the DISLIN directory to the GCC INCLUDE environment

     for example:  SET C_INCLUDE_PATH=C:/DJGPP/INCLUDE;C:/DISLIN

  e) Now you can compile,  link and run the example program  in the
     directory \dislin with the command

                    clink  -a  exampls

4.)  Minimum Set of DJGPP .zip Files

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

     djdev200.zip
     bnu252b.zip
     gcc272b.zip
     grx20.zip
     csdpmi3b.zip  (DPMI Server)   

5.)  Programming in Fortran

     The DISLIN distribution file dl_g7_63.zip supports Fortran 
     programming with G77 and F2C for DJGPP.

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

