libGAP for Debian
=================

This is the development package documentation for libGAP[-Sage[Math]].

To prevent naming collisions with material (already or possibly) provided
by the Debian GAP packages (in particular gap-dev), the upstream naming
scheme had to be adapted: basically the suffix -sage has been appended
whenever applicable, given that libGAP is mainly attended to the Computer
Algebra System (CAS) Sage[Math]. So the Debian source package for libGAP
is libgap-sage, and so forth.

Concerning the development material, the headers are gathered in
/usr/include/libgap-sage/gap and the library name is [lib]gap-sage.
To render it transparent for the end-developers, a pkg-config(1)
metainformation file is distributed with the Debian package. For
instance, to obain C compiler and linker options, you want to enter

	$ pkg-config libgap-sage --cflags --libs


If you have installed the libgap-sage-doc package, you will find
some examples in /usr/share/doc/libgap-sage-doc/examples .
A Makefile to build and test all examples is provided; its header
contains suggestions on how to proceed.

Upstream information on the libGAP C library can be read in the PDF
slides /usr/share/doc/libgap-sage-doc/libGAP.pdf written by the upstream
author himself.

 -- Jerome Benoit <calculus@rezozer.net>  Tue, 16 Aug 2016 14:11:30 +0000
