******************************************************************
**                                                              **
**               IBM PC Installation of DISLIN                  **
**                                                              **
**  Contents:  1.)  Introduction                                **
**             2.)  Installation of DISLIN                      **
**             3.)  Minimum Set of DJGPP .zip Files             **
**             4.)  Using Super VGA Cards                       **
**                                                              **
**  Date   :   15.04.2003                                       **
**  Version:   8.1   /  MS-DOS, G77 (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 Fortran compiler G77.
       
     Note:    This version of DISLIN is free software.  You can 
              copy and redistribute it. 

2.)  Installation of DISLIN

     The  DISLIN version  for the  MS-DOS  compiler  G77/DJGPP  is
     distributed in the zipped file  dl_81_g7.zip.  An utility for
     unpacking the DISLIN files is available from the same locati-
     on where you have downloaded dl_81_g7.zip, or from the DISLIN
     CD-ROM. 

     To install DISLIN, make the following steps:

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

     for example:   md  c:\temp
                    cd  c:\temp
                    copy e:\dislin\msdos\unzip.exe    *.*
                    copy e:\dislin\msods\dl_81_g7.zip *.*

  b) Extract the DISLIN files with the command:

                    unzip -o dl_81_g7

  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  exampls    (for G77)

3.)  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
     g770523b.zip

     grx23.zip      (optional)


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