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://gitlab.torproject.org/tpo/core/torsocks.git

1. Fetch new commits from upstream repository:

    $ git fetch tor-upstream

2. Verify the tag for the new version:

    export VERSION="0.2.3"

    $ 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-${VERSION}.tar.xz --upstream-vcs-tag=v${VERSION} -u${VERSION} --pristine-tar

5. Hack, improve, update debian/changelog…

6. Build a new package:

    $ gbp buildpackage

7. Create a new signed Git tag

    $ git tag -s debian/$VERSION-1

8. Push

    $ git push origin master && git push origin --tags
