File	Date	Author	Commit
doc	2017-04-27	Simon Wright	[1a8f4a] Update for release.
src	2018-07-01	Simon Wright	[182d19] Remove warnings reported by GCC 8/CE 2018.
test	2018-07-01	Simon Wright	[182d19] Remove warnings reported by GCC 8/CE 2018.
.hgignore	2018-07-01	Simon Wright	[182d19] Remove warnings reported by GCC 8/CE 2018.
.hgtags	2017-04-27	Simon Wright	[9003e6] Added tag release-20170427 for changeset 1a8f4a...
CHANGES	2017-04-27	Simon Wright	[1a8f4a] Update for release.
Makefile	2017-04-27	Simon Wright	[1a8f4a] Update for release.
README	2017-04-27	Simon Wright	[1a8f4a] Update for release.
gnat_math_extensions.gpr	2017-04-27	Simon Wright	[1a8f4a] Update for release.

Read Me

This is the README file for distributions of the Ada 2005 Math
Extensions project (https://sourceforge.net/projects/gnat-math-extn/)
on SourceForge.

The purpose of this project is to provide additional matrix
capabilities beyond those defined in the Standard Library (Annex G of
the ARM). The implementations, which are only for GNAT, are in the
form of bindings to the LAPACK and BLAS libraries which are widely
available if not already provided on all operating systems.

Prerequisites
=============

BLAS and LAPACK are required to be on the library lookup path (so that
the linker switches "-llapack -lblas" find them).

On macOS, they are part of the vecLib framework (though, as of Sierra
10.12.4, LAPACK is still at version 3.2.1).

On Debian, check out liblapack3, libblas3.

On Windows, check out LAPACK for Windows at
http://icl.cs.utk.edu/lapack-for-windows/lapack/

Installation
============

The software unpacks into a directory structure of the form

gnat-math-extn-YYYYMMDD
   /src  contains the library code
   /test contains unit tests.

Execute "make". This will build a static library for use in your own
programs, and a test program (test/tests) using AUnit.

In order to use the library within your own code, you need to use a
GPR referencing the extensions' GPR, "gnat_math_extensions". You can

* say 'with "gnat_math_extensions";' and include
  /where/ever/gnat-math-extn-YYYYMMDD in your ADA_PROJECTS_PATH
  environment variable; or

* say 'with "/where/ever/gnat-math-extn-YYYYMMDD/gnat_math_extensions";'
  (this path can be relative, if you like).

* install with your compiler by saying 'make install'. You can then
  say 'with "gnat_math_extensions";'

Testing
=======

Unit tests are based on AUnit version 3 (part of GNAT GPL), which is
expected to be installed.