libgtkada for Debian
---------------------

This package follows the convention for Ada library packages in
Debian. Each library has an ALIVERSION and a SOVERSION. Your
computer'system is designated by a GNU_TRIPLET like x86_32/linux/gnu
for example.

The separate libgtkaALIVERSION-dev package provides tools for
programmers writing software using the library.

The Ada source files are in /usr/share/ada/adainclude/gtkada.

The Ada library information files are in
/usr/lib/GNU_TRIPLET/ada/adalib/gtkada.

There is, in addition, a GNAT project file in
/usr/share/ada/adainclude/gtkada.gpr.

All these settings, as well as linker options, are provided by the
gtkada-config tool.

Thus, there are two ways to use gtkada in your programs:

1. gnatmake your_main_program.adb $(gtkada-config)

2. Write a project file for your program.  Use the project file for
   gtkada as explained in the comments in the project file.

The documentation and examples are provided by libgtkada-doc
package in /usr/share/doc/libgtkada-doc.

The runtime debug symbols are provided by libgtkada-dbg package.

All that remains true for libgtkadagl (optional OpenGL support) and
libgnomeada (optional GNOME support).

A GTK equivalent of the dialog command-line utility is provided in
libgtkada-bin.

Because the Debian packaging compiles GtkAda with Debian GCC instead of
GNAT GPL Edition, I expect that they are *not* binary-compatible with
AdaCore's binaries. Therefore the sonames of the libraries are changed.

Licensing changes
-----------------

See README.source.

Notes about testgtk
-------------------

The Debian package libgtkada-doc provides the sources for testgtk in
/usr/share/doc/libgtkada-doc/examples/testgtk.tar.gz.  This tarball
also contains two Debian-specific files that make it easy to compile
testgtk on Debian systems, like this:

$ mkdir -p ~/src
$ cd ~/src
$ tar xzf /usr/share/doc/libgtkada-doc/examples/testgtk.tar.gz
$ cd testgtk
$ make -f testgtk.mak

The upstream Makefile is also provided but won't work out of the box
because it assumes that the build takes place within the GtkAda source
tree.

 -- Nicolas Boulenguez <nicolas@debian.org>, Sat, 13 Jul 2013 23:48:28 +0200
