# Emacs will be in -*- Mode: text -*-
#
# $Id: INSTALL,v 1.3 1997/02/08 16:21:24 prudhomm Exp $
#
# SUMMARY:      
#
# AUTHOR:       Christophe Prud'homme
# ORG:           
# EMAIL:	Christophe.Prudhomme@asci.fr
#
# ORIG-DATE:     2-Nov-96 at 03:52:18
# LAST-MOD:      2-Nov-96 at 03:52:18 by Christophe Prud'homme
#
# DESCRIPTION:  
#
# $Log: INSTALL,v $
# Revision 1.3  1997/02/08 16:21:24  prudhomm
# many changes
# support for EMACS
# added new directories: contrib ...
#
# Revision 1.2  1996/11/02 03:31:51  prudhomm
# Transfered informations from README to INSTALL
# updated NEWS
#
# DESCRIP-END.


IMPORTANT: there is a C preprocessor flag to enable the mesh adaptation
           called ADAPT see makefile.x (UNIX), syntaxic.cpp(MAC),
           the project(PCs)
           Note : by default this feature is disabled

Installation of freefem for Mac:
______________________________________________________
* Two exec files are provided. One for the PPC processor with adaptmesh
  capabilities and one for the 68K with coprocessor without adaption.

* To recompile freefem use Metrowerks 7.0 or higher and check the option
  "treat ".h" as <.h> files" for the compiler.
  You must add the .cxx extension to tell the compiler to look at these files
  and associate Metrowerks to them as compiler.
  It makes use of the flag -D__MWERKS__ so if you ever use another compiler
change this.



Installation of freefem for unix workstations and Mac:
______________________________________________________
 -- new method:
This is fairly simple now. Everything is based on the autoconf and automake
utilities form the GNU Project.

You might want to read GNUINSTALL for further information about autoconf, 
configure and related stuff.

Version of automake and autoconf:
    ** autoconf-2.12
    ** automake-1.1l: not an official release ask Tom Tromey <tromey@creche.cygnus.com> for it

Here are different ways:
 * Compile without adaptation library or gfem (default way) type:

   configure
   make

 * Compile with adaptation library, type:
  
   configure --with-adapt
   make

 * Compile so that you can use gfem and freefem together. Note that the
   adaptation library is enabled in this case so that you <<do not>> have to write
   --with-adapt: 
  
   configure --with-gfem
   make

it has been tested on :
      * mips-sgi-irix6.2
      * i686-unknown-linux
      * i586-unknown-linux
      * hppa1.1-hp-hpux10.20


MULTI-PLATFORM COMPILATION: if you want to compile freefem on multipe platform
at the same time this is also very easy: 

   mkdir <any directory name accordingly to the platform>
   cd <any directory name accordingly to the platform>
   ../configure <with any options you find useful>
   make


 -- old method:
WARNING: may be makefile.x is not up to date.
--------
edit the makefile.x and make the changes
        - check and change the name of your C++ compiler
        - X11 directories for include files and libraries
        - add -DADAPT if you want to use the adaptation mesh facilities in
freefem
        - add -DDEBUG if you want 'adapt' to be in debugging mode

then do
        make -f makefile.x

normally everything should compile correctly

for PC under windows 32 bit
___________________________
* Create a project with all the files(.cpp extension) (including adapt/*.cpp)
except macrgraph.cpp and xrgraph.cpp

* If you use Microsoft Visual 2.0, add _COMPLEX_DEFINED as a preprocessor
variable and the variable MVC(see pcrgraph.cpp)

* Do not forget the set up the correct include directories (adapt)
add ADAPT or DEBUG to your preprocessing directives

* Add include path to freefem folder to unable the comiler to find the .h files
(because all .h files are declared as #include <filename.h> )

*Then launch freefem; a window with a dialog box will appear to select the
.pde file

