* Installation of E3D, the Euro3D visualization tool
* Version 1.2
* S.F.Sanchez, 17.03.04

Known problems
--------------

(*) When I run the ./makemake for installing PGPLOT I got a message
    saying that I cannot find F77 (or G77) or that it does not
    generate executables.

    Reasons:
    (a) In certain "default" Linux distributions fortran it is not
    included (e.g., Suse). Therefore, since there is no fortran
    compiler it is not possible to install PGPLOT. You need to
    download a fortran compiler or expecify this package using your
    distribution installation tool (e.g., yast).

    (b) There is a redefinition of the G77 enviromental variable.
    If you have installed IRAF in your computer, using the CD "Linux
    for Astronomy", or similar, it does include a redefinition of G77
    (or F77),pointing to a non standard script that does not necesary generate
    executables. For checking that you should do:
    echo $G77 or echo $F77
    if it points to a certain script, then should redifine it prior to
    install PGPLOT:
    e.g., setenv G77 g77

(*) When I run the ./make for compiling PGPLOT I got an error message
    saying that it cannot find the "tk" or/and the "tcl" libraries.

    Reasons:
    (a) You do not have tcl/tk libraries installed in your computer.
    This libraries are normally distributed with the mayority of the
    Unix/Linux OS, however we have found cases where this is not the
    case.

    For testing if you have the tcl/tk libraries installed you should
    try:
    ls /usr/lib/libtk* 
    ls /usr/lib/libtcl*  
    or 
    ls /usr/lib/local/libtk* 
    ls /usr/lib/local/libtcl*
    
    If you do not have any of the libraries, then you have to install 
    the Tcl/Tk libraries.  For doing so, go to webpage:
    http://www.tcl.tk/
    and follow the instructions in there.

    (b) You have the tcl/tk libraries, but they do not have a symbolic
    link between the standard name (e.g., libtk.so), and the current
    version name (e.g., libtk8.4.so). 

    You can tests that this is the reason repeating the "ls" command
    in (a). If you see the libriries (e.g., /usr/lib/libtk8.4.so) but
    not the standard name (e.g.,  /usr/lib/libtk.so), then you do not
    have this link.
    We have found this problem under certain Suse distributions, and
    under Solaris. 

    (Solution A)
    For solving this problem you have to edit the "makefile" under the 
    PGPLOT directory, and change the definition of TK_LIBS, from the
    default definition:
    TK_LIBS=-L/usr/lib -ltk -ltcl -L/usr/X11R6/lib -lX11 -ldl
    to:
    TK_LIBS=-L/usr/lib -ltkN.N -ltclN.N -L/usr/X11R6/lib -lX11 -ldl
    Where N.N is the version number of the tcl/tk library (that you
    get from the "ls").
    e.g.,
    TK_LIBS=-L/usr/lib -ltk8.4 -ltcl8.4 -L/usr/X11R6/lib -lX11 -ldl

    (Solution B)
    If you have superuser access in your machine, then you may try to
    do a symbolic link between the physical libraries (libtk8.4 and
    libtcl8.4) in the directory /usr/X11R6/lib, and the expected ones
    (libtk and libtcl). In that case you should not apply solution A.


(*) I have compiled PGPLOT and the LCL library, but when I try to
    compile E3D, running "make", it breaks when trying to compile 
    "Euro3D.c". I got the message:

    Euro3D.c:17:43: IFU_io.h: No such file or directory
    Euro3D.c:18:41: data_io.h: No such file or directory

    In this case the compiler cannot find the LCL library path.
    This could be due to the use of a wrong version of LCL, or
    an inconsistency between the installed version and the version
    that has been indicated to E3D to look for.

    For checking this you should look for the name of the parent
    directory of the LCL library directory tree. It should be
    something like:
    E3D_io_LCL-1.0c  (i.e., version 1.0c of LCL)

    Read the file "add_defs/makedefs" under the E3D arquitecture.  The
    first not commented line includes the definition of the directory
    of where to look for the LCL library (stored in the variable
    C_ioLIBS_PATH). It should be:    
    C_ioLIBS_PATH = $(topdir)/../E3D_io_LCL-1.0c

    If you have another version of the LCL library (e.g., the 1.0a)
    you should modify this file prior to compile.
