Please replace PKG with gtkada as this documentation is shared by most
Adacore packages.

Three versioning schemes are involved.
* Commercial non GPL releases are numbered MAJOR.MINOR on Adacore
  website.
* Development builds between MAJOR.MINOR and NEXTMAJOR.NEXTMINOR
  releases are numbered NEXTMAJOR.NEXTMINORw (w as wavefront).
* Every year, a tarball is distributed on http://libre.adacore.com
  with the current year as version number, and every header stripped
  from the paragraph granting the GCC Runtime Library Exception.
* Each Debian package is based on a GPL release, but numbered
  MAJOR.MINOR.YEAR in order to ease comparison with other versions.

Upstream history is visible on GitHub at https://github.com/AdaCore/PKG.
The version number is always visible in first line of ./configure.in.
Each commercial release is tagged PKG-MAJOR.MINOR.
Each GPL release is prepared in a branch named gpl-$YEAR.

When packaging a new version for Debian:
choose a version according to the git history,
then rename the symlink or the repackaged archive accordingly.
# uscan
# mv ../PKG_YEAR.orig.tar.xz ../PKG_MAJOR.MINOR.YEAR.orig.tar.xz

The monotone repository at www.ada-france.org once used to track GPL
versions from the public part of the upstream CVS repository in a
branch named com.adacore.PKG, and the repackaged sources in a
branch named com.adacore.PKG.debian, but this seems redundant with
the public git repository now.

 -- Nicolas Boulenguez <nicolas@debian.org>, Sun,  9 Jul 2017 17:09:31 +0200
