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.

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/calligra-l10n/calligra-l10n-{ar,bg,ca}-2.9.11.tar.bz2

produces:

  $ ls -1 ../calligra-l10n*
  ../calligra-l10n_2.9.11.orig-ar.tar.bz2
  ../calligra-l10n_2.9.11.orig-bg.tar.bz2
  ../calligra-l10n_2.9.11.orig-ca.tar.bz2
  ../calligra-l10n_2.9.11.orig.tar.bz2
  $ ls -1 -d *
  ar
  bg
  ca

