******************************************************************
**                                                              **
**               IBM-PC Installation of DISLIN                  **
**                                                              **
**  Contents:  1.)  Introduction                                **
**             2.)  Installation of DISLIN                      **
**             3.)  Minimum Set of DJGPP .zip Files             **
**             4.)  Programming in Fortran                      **
**             5.)  Using Super VGA Cards                       **
**                                                              **
**  Date   :   15.04.2003                                       **
**  Version:   8.1  /  MS-DOS, GNU-GCC (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.)  Installation of DISLIN

     The  DISLIN version  for the  MS-DOS  compiler  GCC/DJGPP  is
     distributed in the zipped file  dl_81_dj.zip.  An utility for
     unpacking the DISLIN files is available from the same locati-
     on where you have downloaded dl_81_dj.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_dj.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_dj.zip *.*

  b) Extract the DISLIN files with the command:

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

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

     grx23.zip      (optional)

4.)  Programming in Fortran

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

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


