USAGE

Reverse dependencies using gnatmake/gnatlink must upgrade at least to
4.6.4-1 to circumvent #680292.

Debug packages built using dh_ada_library <= 5.3 try to link their
documentation directory to the one in the library package. It may
create upgrade problems for the packages, as dpkg refuses to replace a
directory with a symbolic link or the reverse.
See https://wiki.debian.org/MissingCopyrightFile.

For versions << 5.5, the "dh --with ada-library" method runs
dh_ada_library before dh_install. If your lib or -dev package installs
other binaries with dh_install, they won't be stripped (see WHEN
section below). Example of work-around:
override_dh_ada_library:
        dh_install # or whatever installs the binary
        dh_ada_library

WHEN

Dh_ada_library calls dh_strip twice.
 - on -lib with options storing the debugging information into -dbg,
 - on -dev before installing the static archive to preserve it,
So it needs to be executed before dh_strip is called by dh with the
default configuration.

In case -lib or -dev install other binaries (say into /usr/lib/NAME
for -lib or /usr/bin for -dev), policy wants them to be stripped so we
must run after dh_install.

Dh_ada_library appends lintian override to existing files, while
dh_lintian blindly overwrites them, so it is better to run
dh_ada_library after dh_lintian.

As most of the job is installing files, good logic says that we should
come before dh_link/dh_compress/dh_fixperms.

Since 5.5, "dh --with ada-library" inserts dh_ada_library right after
dh_lintian.

BUILD

Version numbering: X.Y, where X only increases when source changes are
needed in reverse dependencies.

The lintian hardening-no-fortify-functions warning seems to be
ignorable in 5.1. "hardening-check --verbose /usr/bin/dh_ada_library"
only reports memmove and memcpy, which are not called (directly) by
any Ada code.
