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.

                                            2015-10-19                          DH_ADA_LIBRARY(1)