D_Bus/Ada
=========

The D_Bus/Ada library provides an Ada binding to the D-Bus message bus used for
inter-process communication on most modern Linux desktop systems.


Licence
-------
--------------------------------------------------------------------------------
Copyright (C) 2011 Reto Buerki <reet@codelabs.ch>. Free use of this software is
granted under the terms of the GNAT Modified General Public License (GMGPL).
--------------------------------------------------------------------------------


Download
--------

Release version
~~~~~~~~~~~~~~~
The current release version of D_Bus/Ada is available at
http://www.codelabs.ch/download.

Verify a Release
~~~~~~~~~~~~~~~~
To verify the integrity and authenticity of the distribution tarball, import
the key http://www.codelabs.ch/keys/0x3DC359DEpub.asc and type the following
command:

  $ gpg --verify libdbusada-{version}.tar.bz2.sig

The key fingerprint of the public key ('0x3DC359DE') is:

  Key fingerprint = 752C 4EBC 115D 5EAD 75F7  0F34 A0AE 8AD7 3DC3 59DE

Development version
~~~~~~~~~~~~~~~~~~~
The current development version of D_Bus/Ada is available through its git
repository:

  $ git clone http://git.codelabs.ch/git/dbus-ada.git

A browsable version of the repository is also available here:
http://git.codelabs.ch/?p=dbus-ada.git.


Build
-----
To compile D_Bus/Ada on your system, you need to have the following software
installed:

* GNAT compiler:
  http://www.gnu.org/software/gnat/gnat.html

* Ahven (Test-Framework):
  http://ahven.stronglytyped.org/

* D-Bus development files and libraries:
  http://dbus.freedesktop.org/

* Glib with D-Bus support


Testing
-------
Before you install D_Bus/Ada on your system, you might want to test the library
and verify that everything works as expected. D_Bus/Ada contains an unit test
suite which can be run by entering the following command:

  $ make tests


Installation
------------
To install D_Bus/Ada on your system, type the following:

  $ make PREFIX=/usr/local install

If no `PREFIX` is specified, `$(HOME)/libraries` is used as install destination.


Examples
--------
D_Bus/Ada provides example code to demonstrate the usage of the D_Bus/Ada API.
To build all examples type the following:

  $ make examples

You can start an example application like so: `obj/examples/list_names`.
