The versions given here should be taken as examples.

Latest upstream release
-----------------------

The official releases may be downloaded from the AdaCore site.
- browse to http://libre.adacore.com/download/
- select "Free Software or Academic Development"
- click on "Build your download package"
- select any platform and "GNAT GPL 2014"
- select "GNAT GPL 2014"
- click on the aws-gpl-2014-src.tar.gz hyperlink (not the toggle button)

Repackaging of the upstream tarball
-----------------------------------

I have choosen to not to redistribute the upstream tarball because the
generated documentation makes it six times bigger than necessary. The
command line below solves this issue, uses a better compression scheme
and gives the archive a name compatible with Debian standards.

Inside a (probably older) Debian source tree:
# mk-origtargz ../aunit-gpl-2014-src.tar.gz --repack --compression=xz
or anywhere:
# mk-origtargz aunit-gpl-2014-src.tar.gz --repack --compression xz \
  --package libaunit --version 3.7.1 \
  --exclude-file "foo" --exclude-file="bar"
For a list of excluded files, see debian/copyright

Use of the version control system
---------------------------------

You may either create an empty Monotone database
# mtn -d $db db init
or use an existing one.

All work on this package is tracked in the
www.ada-france.org monotone repository.
# debian_branch=org.debian.libaws tracks the Debian packaging

Download the branches from the server to your database.  The first
time you contact this server, monotone will show its key. You should
check that it matches f8a11727e8983cf9083c08c6a2acaa27e439dd39.
# server=www.ada-france.org
# mtn -d $db pull mtn://$server?$debian_branch

Inspect the unpatched source tree.
# tar xf libaws_3.2.0.orig.tar.xz
# cd aunit-3.7.0w-src
# mtn -d $db checkout -r h:$debian_branch .

Build the package
# debuild

Beware that:
- mtn status does not list all changes. Try "mtn list missing", "mtn
  list unknown", "mtn list ignored" and "mtn status" to get the
  equivalent of "git status".
- Monotone will detect changes outside debian/ caused by patches.
  Always "quilt pop -a" when preparing a commit.

 -- Nicolas Boulenguez <nicolas@debian.org>, Mon, 18 Aug 2014 14:20:28 +0200
