Debian packaging for torsocks
=============================

torsocks is managed in a Git repository using git-buildpackage (with
pristine-tar). It follows most of the advices provided by Russ Allbery at:
http://www.eyrie.org/~eagle/notes/debian/git.html

As upstream is using Git, release tags are merged into the 'upstream' branch of the
Debian package repository when importing new tarballs.

Creating an updated package for a new upstream release goes as:

0. Add a remote with upstream repository if not already done:

    $ git remote add tor-upstream https://git.torproject.org/torsocks.git

1. Fetch new commits from upstream repository:

    $ git fetch tor-upstream

2. Verify the tag for the new version:

    $ git tag -v <version>

3. Download and verify the upstream tarball:

    $ uscan

4. Import new upstream tarball (e.g. 2.0.0):

    $ gbp import-orig ../torsocks-2.0.0.tar.bz2 --upstream-vcs-tag=v2.0.0 -u2.0.0 --pristine-tar

5. Hack, improve, update debian/changelog…

6. Build a new package:

    $ gbp buildpackage
