DH_ADA_LIBRARY(1)

NAME
dh_ada_library - aide à empaqueter des bibliothèques Ada pour Debian

SYNOPSIS
dh_ada_library [options debhelper] [[variable=valeur ...] projet.gpr] ...

DESCRIPTION
dh_ada_library est un programme de la suite debhelper prenant en charge quelques tâches courantes dans l’empaquetage de bibliothèques écrites dans le langage Ada.

Chaque argument projet.gpr indique un fichier de projet GNAT servant à compiler une des bibliothèques partagées fournies par le paquet source. L’usage de variables d’environnement dans de tels projets étant monnaie courante, il est possible de fournir une liste d’affectations avant chaque projet.

dh_ada_library lit chaque fichier de projet et en extrait les informations suivantes : le nom de la bibliothèque, les projets importés, les répertoires contenant les sources, le répertoire contenant la bibliothèque partagée (Library_Dir), celui contenant les fichiers ALI (Object_Dir), et les options de l’éditeur de liens (Leading_Library_Options et Library_Options). Ensuite, il parcourt debian/control afin de vérifier que trois paquets existent, nommés conformément à la Charte Debian pour Ada sous l’intitulé Coexistence Not Allowed et il en déduit le numéro de version des fichiers ALI (aliversion) et de la bibliothèque partagée (soversion). Puis, dh_ada_library traite chacun des trois paquets de la façon suivante.

  Paquet fournissant la bibliothèque dynamique
dh_ada_library installe la bibliothèque partagée (mode 644) dans le paquet, puis, si debian/control mentionne un paquet -dbg, exécute dh_strip avec des options plaçant les informations de déboguage dans le paquet -dbg.

Si la bibliothèque partagée déclare sa pile exécutable, dh_ada_library génère un « override » lintian expliquant que GNAT utilise des trampolines pour traiter les exceptions. Avant cela, dh_lintian est exécuté, car s’il l’était plus tard il risquerait de recouvrir le fichier « override ».

  Paquet contenant les symboles de déboguage (-dbg)
Le fichier /usr/share/doc/dh-ada-policy/README.Debian décrit comment rendre les mêmes services avec moins d’efforts.

Si debian/control mentionne un paquet -dbg, les variables de substitution ada:Depends, ada:Recommends, ada:Suggests reçoivent des valeurs indiquant que le paquet -dbg dépend du paquet de bibliothèque, recommande le paquet -dev et suggère le paquet gnat.

Les version <= 5.3 remplaçaient le répertoire de documentation par un lien symbolique vers celui du paquet de bibliothèque, mais cela s’est avéré à l’usage cause de problèmes lors des mises à jours. Si un paquet binaire construit avec une telle version a été distribué, le paquet source devrait ajouter des scripts de maintenance comme décrit à l’adresse https://wiki.debian.org/MissingCopyrightFile.

  Paquet de développement (-dev)
Pour commencer, dh_ada_library installe le lien symbolique de développement habituel (*.so -> *.so.soversion), les fichiers ALI (mode 444) et les sources (mode 644) dans le paquet -dev. Les langages autres qu’Ada mentionnés dans le projet sont pris en compte, qu’ils aient été pris en compte auparavant par gprbuild, ou ignorés par gnatmake et compilés séparément. Ensuite, il recherche un fichier nommé libLIBRARY_NAME.a (la bibliothèque statique) dans le répertoire courant ou un de ses sous-répertoires, et l’installe (mode 644) dans le paquet -dev.

Un second fichier de projet, conçu pour faciliter la compilation de programmes utilisant la bibliothèque, est généré et installé dans le paquet -dev. Le paquet Linker du nouveau projet hérite des options destinées à l’éditeur de liens -l ou -L mentionnées dans les attributs Leading_Library_Options ou Library_Options du projet de compilation.

Chaque renommage est transmis au projet généré.

dh_ada_library exécute dh_strip avant d’installer la bibliothèque statique afin que celle-ci conserve ses informations de déboguage.

La variable de substitution ada:Depends reçoit une valeur indiquant que le paquet dépend de gnat, de gnat-X.Y et du paquet de bibliothèque. Pour chaque projet de bibliothèque importé et reconnu, soit comme déjà parcouru, soit comme installé dans le système de construction par dpkg-query, une dépendance est ajoutée dans ada:Depends et le projet généré se voit ajouter une ligne with. Dans le cas d’un projet déjà parcouru dans le cadre du même paquet source, la dépendance exige exactement la même binary:Version, afin de garantir que toutes les archives statiques sont compilées avec des options compatibles.

REMARQUES
Ce programme ne fait pas partie de la suite debhelper. Pour l’activer, veuillez lancer le séquenceur dh avec l’option --with ada-library.

L’attribut Library_Version du projet est délibérément ignoré, et le nom d’objet partagé (soname) est plutôt déduit à partir du nom du paquet de bibliothèque. Les projets réclamant une définition de variable externe pour définir cet attribut pourront recevoir une valeur arbitraire. Ceci permettra souvent au mainteneur l’usage d’un simple fichier debian/ada_libraries au lieu de surcharger une commande debhelper ou d’exporter une variable d’environnement.

Les deux bibliothèques et les fichiers ALI sont installés dans /usr/lib/DEB_HOST_MULTIARCH, le projet et les sources dans /usr/share/ada/adainclude. Ceci signifie que le paquet -dev ne peut pas être déclaré Multi-Arch: same puisque le contenu du projet (et le cas échéant de sources générées) sera différent selon l’architecture.

FICHIERS

debian/ada_libraries
    Projets et variables à traiter en plus de ceux mentionnés en ligne de commande en cas d’appel directement depuis debian/rules. Les fins de ligne sont considérés comme de simples espaces. Ceci peut être amené à changer, et il est vivement recommandé de mettre exactement une affectation ou un projet par ligne. Toute ligne débutant par un dièse est ignorée.

OPTIONS
Les options en ligne de commande et variables d’environnement communes aux outils debhelper sont reconnues.

EXEMPLES
dh_ada_library 'DIRS=src gen' SOVERSION=sans_effet toto.gpr --verbose --no-act

VOIR AUSSI
debhelper(7), dh_installdocs(1), dh_lintian(1), dh_strip(1), deb-substvars(5), la Charte Debian pour Ada disponible (en anglais) à l’adresse http://people.debian.org/~lbrenta/debian-ada-policy.html.

AUTEUR
Nicolas Boulenguez <nicolas@debian.org> a écrit dh_ada_library et sa page de manuel à destination du projet Debian et de quiconque les trouvera utiles.