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-2018 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
https://www.codelabs.ch/download/.

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

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

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

  Key fingerprint = A2FB FF56 83FB 67D8 017B  C50C F8C5 F8B5 BB79 3815

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

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

A browsable version of the repository is available here:
https://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://www.freedesktop.org/wiki/Software/dbus/

* 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`.
