/************************************************************************/
/**                                                                    **/
/**                 FreeBSD Installation of DISLIN                     **/
/**                                                                    **/
/** Contents: 1.) Introduction                                         **/
/**           2.) Installation of Libraries and Utility Programs       **/
/**           3.) Installation of Plot Devices                         **/
/**           4.) FTP Sites.                                           **/
/**                                                                    **/
/** Date   : 09.10.1997                                                **/
/** Version: 6.3    / FreeBSD 2.2.2, gcc + g77 + f2c                   **/
/** Author : Helmut Michels, Tel.: +49 5556 979 334                    **/
/**          MPI fuer Aeronomie, Max-Planck-Str. 2,                    **/
/**          D-37191 Katlenburg-Lindau, Germany                        **/
/** Mail:    michels@linmpi.mpg.de                                     **/
/************************************************************************/

1.) Introduction

   DISLIN is a high level and easy to use graphics library for displaying
   data as curves,  bar graphs,  pie charts,  3D-colour plots,  surfaces,
   contours and maps. The software is available for several C, Fortran 77
   and Fortran 90 compilers.

   The UNIX versions of the graphics software  DISLIN  are distributed as 
   compressed tar files with the file names 'dislin_xxx.nn.tar.gz'  where
   nn contains the  DISLIN  version  while  the part  xxx  identifies the 
   machine.  

   Notes: - DISLIN is compiled with gcc 2.7.2. 

          - DISLIN for FreeBSD  supports Fortran programming with f2c and 
            g77. 

          - DISLIN uses X11 for graphical output on terminals.

          - The FreeBSD version of DISLIN is free software.


2.) Installation of Libraries and Utility Programs

a) Uncompress the tar.gz file with the command

                  gzip -d     dislin_fbsd.nn.tar.gz


b) Restore files from the tar file with the command

                  tar   xvf   dislin_fbsd.nn.tar    

c) Change to the installation directory of DISLIN

                  cd    dislin_6.3

d) Choose a directory in the file structure where DISLIN should be
   installed and define the environment variable DISLIN with it:

   For example:    DISLIN=$HOME/dislin
                   export DISLIN
    
e) Run the install program with the command 

                   INSTALL

   This program copies files to $DISLIN and sets protections.

f) To make DISLIN available for general use, write the following com-
   mands to your .profile or to /etc/profile

                    DISLIN=directory                     
                    export DISLIN
                    PATH=${PATH}:${DISLIN}/bin

                    LD_LIBRARY_PATH=$DISLIN:$LD_LIBRARY_PATH
                    export LD_LIBRARY_PATH

g) Now you can compile, link and run the example programs in the
   directory $DISLIN/examples with the commands:

                    clink   -a exa_c      (for gcc)       
                    dlink   -a exa_f77    (for f2c)
                    g77link -a exa_f77    (for g77)

   Note: An alternate linking method can be:

       gcc -o exa_c exa_c.o -L$DISLIN -ldislnc -lm -lX11           (for gcc)
       gcc -o exa_f77 exa_f77.o -L$DISLIN -ldislin -lm -lf2c -lX11 (for f2c)
       g77 -o exa_f77 exa_f77.o -L$DISLIN -ldislin -lX11           (for g77)

h) You can delete the installation directory 'dislin_6.3'.


3.) Installation of Plot Devices

   The driver program disdrv and the subroutine symfil can be used to send
   a plotfile created by DISLIN to a device.  You have to modify  the file 
   device.dat in the DISLIN directory to define a device (see device.dat).
   For example, if you have a PostScript printer with the queuename  xxxx,
   you can insert the following statements into the file device.dat:

   --------------------------
   PSC1
   POST
   lpr -Pxxxx %
   lpr -Pxxxx %
   --------------------------


4.) FTP Sites

   DISLIN is available via ftp anonymous from the following sites:

      ftp://ftp.gwdg.de/pub/grafik/dislin 
      ftp://linhmi.mpae.gwdg.de/pub/dislin     

   The DISLIN Home Page is:

      http://www.mpae.gwdg.de/dislin/dislin.html