	
    2-Dimensional Finite Difference Hartree-Fock program
                       (version 1-2003) 

 This file describes the configuration, compilation and installation
 of the 2D HF program.

 It is assumed that the following files have been successfully
 extracted from the archive:

   ./COPYING -- terms of the GNU General Public License
         	
   ./INSTALLATION -- this file
      
   ./README 

   ./CHANGES 

   ./Makefile -- file required to build source files and compile/link
	      the program (checked with GNU Make, version 3.79.1, and
	      GNU bash, version 2.05b.0(1))

   ./Run_tests.pl -- a (Perl) script for running some test cases 

   ./bin/xhf -- script facilitating execution of the program

   ./doc/users_guide.pdf 
	 users_guide.html/users_guide.html -- description of input data 
	 2dhf.pdf -- description of the program

   ./examples  -- a number of test calculations (input/output data) 

   ./src/main-qstatic.inc
	     main-dynamic-f77.inc
	     main-dynamic-f77-dec.inc
	     main-dynamic-f90.inc

	     blk_data.inc.raw
	     commons8.inc.raw 
	     commons16.inc.raw

	     dointerp.f.raw   
	     dointerp_nu.f.raw   
	     dointerp_mu.f.raw   
 	     fill2.f.raw      
	     fill3.f.raw      
	     fill4.f.raw      
	     main_2dhf.f.raw  
	     prepg94.f.raw    
	     prepg94l.f.raw   
	     quadp.f.raw      
             r_exponents.f.raw
	
	     fmalloc.c
	     getdatetime.c
	     getusedcpu.c
     
             *.f


 Follow the steps:

   1. Edit Makefile to specify variables needed to build include and
      source files, the system type, compiler and libraries.

      If MEMALLOC is set to 'qstatic' edit ./src/main-qstatic.inc to
      set the required configuration and the grid size.

   2. Execute 'make all' to produce *.inc and *.f files out of the
      corresponding *.raw one, compile source files and put the object
      files in ./obj directory and make the executable ./bin/x2dhf.

   3. Check the program by running it in ./bin using as examples input
      command files from ./examples. Some test can be performed by
      using ./Run_tests.pl script (Perl interpreter is required). The
      corresponding output files are also contained in ./examples. 

   4. See ./doc/users_guide.pdf or ./doc/users_guide/ for the
      detailed description of the input commands and the input/output
      data files and the usage of the script ./bin/xhf_mpi. (Note that
      when xhf_mpi is used to launch the program it will be run with the
      lowest priority (the nice value is set to +19)).

 Hints:

   'make tar.gz' produces a tar gzipped archive file 2dhf_mm.yy.tar.gz

   'make tgz' produces a gzipped tar archive file 2dhf_mm.yy.tgz.

   'make clean-obj' removes object files from obj directory.

   'make clean-bin' cleans bin directory.

   'make all' removes  ./obj directory, prepares *.f and *.inc files, 
    compiles and builds the program.  

   'make all64' builds the program for 64-bit computers


   
