Installation Guide.
===================

These packages contain Ada bindings to the LAPACK subroutines. The sources
for LAPACK itself are not  distributed with this package. The Ada bindings
interface to the Fortran version of the LAPACK library (not C or C++), which
you can obtain from the netlib sites. 

Requirements
============

	Gnat 3.04 ( and gcc 2.7.2 )
	LAPACK Fortran library version 2.0 
	Fortran library 
	  - For F77 complier (SUN), libF77 and libm.
	  - For g77 complier (GNU), libf2c.

You only need a Fortran compiler if you want to do multi-language
programming, or if you need to build LAPACK itself. 

A number of test examples in directories /test and /pilot
assume that you have a Fortran77 compiler available.

TESTING	
=======

Testing procedures interf and lapack can be found in directory /test. 
Interf tests basic compatibility between Fortran compiler and GNAT. Lapack
exercises the tests supplied with LAPACK, through the Ada bindings.

If you install LAPACK from source with your Fortran complier, we
strongly recommend that you  test interf first. More information can
be found in /test/README. 

INSTALL
=======

To use LAPADA, unpack the file in the directory of your choice. Options
for your environment are specified in ada/labase.ads. You may need to
change the names of the fortran compiler and specify some other linker
and library options as specified in that package:

1. You should check the library name for LAPACK. The default is typically
   lapack_"platform".a,  e.g. lapack_sun4.a. Most administrators choose instead
   liblapack.a because the standard linker option is to examine names of
   the form libxxx . 

2. You should check the loader that GNAT uses, it is installation dependent. 
   It may be Sun ld or GNU ld on SUN platforms. If the first, you shoud
   add LD_LIBRARY_PATH to your environment to specify the location of the 
   required library. For GNU ld, you should add 

	pragma Linker_Option (-L"path name"). 

   You can also  use -largs option with gnatmake:

	%gnatmake test -largs -L/local/bra/bra


3.  Add the ada directory for lapada to ADA_INCLUDE_PATH and ADA_OBJECT_PATH
    environment variable. (See the GNAT documentation for their use).

  If you have direct access to the GNAT installation, you can place the
  lapada files in the standard GNAT locations:

  a)  run make in the directory containing lapada files. 
  b)  move *.ads and *.adb into /usr/adainclude
  c)  move *.ali and *.o into /usr/lib/gcc-lib/'platform'/'version'/adalib. 


G77
=== 

If you have compiled LAPACK with  g77, linker_option should be "lf2c" 
(using libf2c rather than libF77). Comment out all F77 options. 
Static option may be required in link phase.
 

Wasu Chaopanon
Wed Mar  6 17:00:50 EST 1996

