Downloading the upstream tarballs
---------------------------------

Since version 4 of the watch format, uscan is able to download all the
tarballs at once, using a watch file. The caveat is that all the upstream
tarballs must be listed. The debian/createwatch script can be used to ease
this process:

  $ debian/createwatch ar ast bg [...] ca@valencia [...] en_GB [etc...]

Then `uscan --report` can be used to check the status, `uscan --download`
to download the tarballs, and so on.

The debian/listlangs can be used to list the langs (this uses the lftp tool,
and it requires the upstream version to look for):

  $ debian/listlangs 17.04.3 | head -5
  ar
  ast
  bg
  bs
  ca

Together with debian/createwatch, you can prepare the debian/watch with:

  $ debian/createwatch $(debian/listlangs 17.04.3)


Generating orig tarballs from the upstream tarballs
---------------------------------------------------

You may use the debian/upstream2orig script to get debian orig tarballs from
the ones supplied by upstream. The script will take care of:

* determining language and version from the tarball filenames;
* stripping incompatible characters from the language IDs;
* hard linking the upstream tarballs to appropriate debian original tarballs;
* extracting the tarballs to appropriate subdirectories in the debian source
  tree;

In order to use debian/upstream2orig script, just pass paths to the upstream
tarballs as arguments and the script will do the rest. For example:

  $ debian/upstream2orig ../tarballs/kde-l10n/kde-l10n-{ar,bg,ca}-4.4.1.tar.bz2

produces:

  $ ls -1 ../kde-l10n*
  ../kde-l10n_4.4.1.orig-ar.tar.bz2
  ../kde-l10n_4.4.1.orig-bg.tar.bz2
  ../kde-l10n_4.4.1.orig-ca.tar.bz2
  ../kde-l10n_4.4.1.orig.tar.bz2
  $ ls -1 -d *
  ar
  bg
  ca

