******************************************************************
**                                                              **
**               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   :   15.02.2000                                       **
**  Version:   7.3   /   GNU-GCC 2.8.1 (from DJ Delorie, V.2)   **
**  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 graphics software
     DISLIN on  IBM PCs  for the operating system  MS-DOS  and the  
     GNU compiler GCC.

     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_73_DJ.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_nn_DJ.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_73_DJ

  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

                    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:

     djdev201.zip
     bnu281b.zip
     gcc281b.zip

     grx23.zip      (optional)

5.)  Programming in Fortran

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

6.)  Using Super VGA Cards

     DISLIN uses by default BIOS calls to display graphics on the
     screen.  Special graphic modes can be defined with the 
     utility program  DISVID (see DISVID). This method is not very
     fast.
     
     To get fast graphical output on the screen, you can use the 
     GRX library as in interface for DISLIN. All you have to do
     is to replace the dummy library DISGRX.A in the DISLIN link 
     procedure CLINK by the real GRX library and to define the
     environment variable GRX20DRV.

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


