********************************************************************
**                                                                **
**               IBM-PC Installation of DISLIN                    **
**                                                                **
**  Contents:  1.)  Introduction                                  **
**             2.)  Installation of DISLIN                        **
**             3.)  Getting a DISLIN License                      **
**                                                                **
**  Date   :   15.10.2006                                         **
**  Version:   9.1   /  Windows, LCC-Win32 Compiler               **
**  Author :   Helmut Michels                                     **
**             MPI fuer Sonnensystemforschung,                    **
**             Max-Planck-Str. 2, 37191 Katlenburg-Lindau,        **
**             Germany                                            **
**             E-mail: michels@mps.mpg.de                         **
********************************************************************


1.)  Introduction

     This file describes the  installation  of the  data  plotting
     software DISLIN on IBM-PCs  for  the operating system Windows
     9x/NT/2000/XP and the LCC-Win32 compiler.


2.)  Installation of DISLIN

     The DISLIN version for LCC-Win32 is distributed in the zipped
     file  dl_91_lc.zip. An utility for unpacking the DISLIN files
     is available from the same location where you have downloaded
     dl_91_lc.zip, or from the DISLIN CD-ROM. 

     To install DISLIN, make the following steps:

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

     for example:   md  c:\temp
                    cd  c:\temp
                    copy e:\dislin\windows\unzip.exe    *.*
                    copy e:\dislin\winwows\dl_91_lc.zip *.*

  b) Extract the DISLIN files with the command:

                 unzip  -o dl_91_lc.zip

  c) Run the setup program with the command

                  setup

     -  Choose OK

     -  Give the Installation Directory where  DISLIN  should be in-
        stalled. The default directory is C:\DISLIN.

  d) Reconfigure the System

     Set the DISLIN environment variable to c:\dislin and include
     c:\dislin\win in your path. If you have installed DISLIN in a
     different directory, you have to use that directory for the 
     environment variables above.

     The setting of environment depends on your Windows version:

     Windows 98/ME

        Add the following commands to the autoexec.bat file

        PATH=c:\dislin\win;%PATH%
        SET DISLIN=c:\dislin   
   
     Windows NT/2000/XP

        In Windows NT/2000/XP environment variables can be set or
        modified with the Control Panel 
        (see Control Panel -> System -> Advanced -> Environment
        Variables).
   
  e) Now you can compile,  link and run the example programs in the
     DISLIN subdirectory examples with the commands

                    clink  -a  exa_c      (for lcc)
                    dlink  -a  exa_f77    (for f2c)
     and 
                    clink  -a  map_c      (for lcc)
                    dlink  -a  map_f77    (for f2c)

     Notes:

         - clink and dlink link by default with the single precision
           library of DISLIN (dislcc.lib). A double precision version
           of the library is also included (dislcc_d.lib). 

         - Normally,  the linker  of LCC creates  a Windows  console 
           program.  This means  that a console is created automati-
           cally  by the  operating system  for  using  standard I/O 
           functions such as printf and scanf.  You can suppress the
           console  window by using the switch  '-subsystem windows'
           in lcclnk. In this case, you can manage I/O with the DIS-
           LIN widget  routines  and you  should  use  the statement
           'winapp ("windows");' before 'disini',  which  means that  
           DISLIN warnings are written to a file and that the proto-
           col in disfin is displayed in a widget.


3.)  Getting a DISLIN License

     DISLIN is free for non-commercial use. Licenses for selling programs
     linked with DISLIN or for using DISLIN in an environment related to
     business are available from the site http://www.dislin.de. 

