******************************************************************
**                                                              **
**               IBM PC Installation of DISLIN                  **
**                                                              **
**  Contents:  1.)  Introduction                                **
**             2.)  Check the Contents of the Disk              **
**             3.)  Installation of DISLIN                      **
**             4.)  Minimum Set of EMX .zip Files               **
**             5.)  Using Super VGA Cards                       **
**                                                              **
**  Date   :   30.11.1996                                       **
**  Version:   6.3   /  GCC+G77, emx09b, emx09c                 **
**  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 compilers EMX GCC and G77.

     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_EM_63.ZIP 
     UNZIP.EXE

3.)  Installation of DISLIN

     The PC version of the graphics software  DISLIN for  EMX  GCC
     adn G77 is distributed as a .zip  file created  with the file
     packaging utility ZIP (version 1.9).  The .zip  file  has the
     file name DL_EM_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_EM_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\DOS directory to the PATH environment in the
     file AUTOEXEC.BAT

     for example:  PATH C:\BIN;C:\DISLIN\DOS;C:\EMX\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:/EMX/INCLUDE;C:/DISLIN

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

                    clink  -a  exampls       for   C

               or   dlink  -a  exampls       for   Fortran

4.)  Minimum Set of EMX .zip Files

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

     emxrt.zip
     emxdev1.zip
     emxdev2.zip
     gnudev1.zip
     gnudev2.zip
     g77bin.zip     for Fortran

     EMX is available for anonymous ftp on

       ftp.leo.org:            /pub/comp/os/os2/devtools/emx+gcc
       ftp-os2.cdrom.com:      /pub/os2/lang/emx09c
       ftp-os2.nmsu.edu:       /os2/unix/emx09c
       src.doc.ic.ac.uk:       /packages/os2/unix/emx09c

5.)  Using Super VGA Cards
     
     At the moment, DISLIN for EMX uses just BIOS calls to display
     graphics on the screen.  Special graphic modes can be defined
     with the utility program  DISVID (see DISVID).

  Notes: 

  -  Elementary image routines such as rtiff, rimage and wpixls are
     not available.
     
