Debian packaging

This section describes the recommended build configuration for building and packaging the official source tarballs and debian packages.








Setting up a build system for the first time

  1. Set DEBEMAIL and DEBFULLNAME environment variables (see

  2. Install the requisite packages:

    sudo apt-get install devscripts pbuilder debhelper \
    git-buildpackage cowbuilder

    Note: if your host is not sid, you might need to install a newer gcc version than exists on the native release. You can do something like this:

  3. Make and register ssh keys:

    ssh-keygen -t rsa -C "" -b 4096 -f ~/.ssh/id_rsa_salsa

    Be sure to set up your ~/.ssh/config file to tell it where to find the key:

    # Add this to ~/.ssh/config
            IdentityFile ~/.ssh/id_rsa_salsa

    Then go to to register the public key. Wait up to one hour for the key to be registered.

  4. Download the relevant directory from the debian-med repository:

    gbp clone --all --pristine-tar
  5. Initial setup of pbuilder environment:

    sudo apt-get install debian-archive-keyring
    git-pbuilder create

    Install packages into git-pbuilder. This saves time when running multiple times:

    git-pbuilder login --save-after-login
    apt-get update
    apt-get install \
      apt-utils fakeroot debhelper \
      cmake \
      libblas-dev liblapack-dev libsqlite3-dev \
      libdcmtk-dev libdlib-dev libfftw3-dev \
      libinsighttoolkit5-dev \
      libpng-dev libtiff-dev uuid-dev zlib1g-dev

    See this link for more information

Step 1: Test the debian build

  1. Download the candidate tarball and repack into correct version name:

    export V=1.7.4
    cd ~/debian-med
    tar xvf plastimatch-master.tar.gz
    rm plastimatch-master.tar.gz
    mv plastimatch-master plastimatch-${V}
    tar cvfz plastimatch-${V}.tar.gz plastimatch-${V}
    rm -rf plastimatch-${V}

    Note that the old version number should be used, as we have not yet updated the version in the debian changelog.

  2. Run debian repacking:

    (cd plastimatch && mk-origtargz ../plastimatch-${V}.tar.gz)
  3. Unzip the created tarball, and copy over the debian directory:

    tar xvf plastimatch_${V}+dfsg.1.orig.tar.[xg]z
    cp -r plastimatch/debian plastimatch-${V}
  4. Refresh your pbuilder environment (if needed):

    sudo pbuilder update
  5. Run debuild and build:

    cd plastimatch-${V}
    debuild -i -us -uc -S
    sudo pbuilder build ../plastimatch_*.dsc
  6. Run lintian on package:

    cd ~/debian-med
    lintian -i *.changes

Step 2: Build the tarball

Follow instructions in Making a tarball.

Step 3: Build the debian package

  1. Clean pbuilder environment (if needed):

    pbuilder clean
  2. Refresh your git-pbuilder environment (if needed):

    git-pbuilder update
  3. Don’t edit changelog yet

  4. Patch git with upstream:

    gbp import-orig --pristine-tar --uscan
  5. The above won’t work if you already edited and committed the debian changelog. Instead, download and then patch.:

    uscan --verbose --force-download
    gbp import-orig --pristine-tar ../plastimatch_1.6.5+dfsg.1.orig.tar.gz
  6. Update changelog (in an terminal, not emacs):

    V=1.9.4              # New version
    cd plastimatch
    dch -v ${V}+dfsg.1-1
    git commit -a -m "Update changelog"

    Don’t forget to change release status to “unstable”

  7. Test:

    gbp buildpackage --git-pbuilder --git-ignore-new -j4 --git-postbuild='lintian -i $GBP_CHANGES_FILE'
  8. If you need select a patch from git, do somthing like this:

    git format-patch HEAD~
  9. Push changes to server:

    git push --all origin && git push --tags origin

Various hints

Switching between git branches

Like this:

git checkout pristine-tar
git checkout upstream
git checkout master

Full reset of repository

Like this:

git checkout pristine-tar
git reset --hard origin/pristine-tar --
git checkout upstream
git reset --hard origin/upstream --
git checkout master
git reset --hard origin/master --
git tag -d upstream/1.6.5+dfsg

Alternatives to running gbp buildpackage

  1. Run gbp buildpackage to create the dsc:

    gbp buildpackage --git-ignore-new -uc -us -j16

    If the host does not contain all needed packages you will need to use pbuilder:

    gbp buildpackage --git-pbuilder --git-ignore-new -uc -us -j16

    All the junk that gbp buildpackage makes, such as the orig.tar.gz and the dsc file, gets put in the parent directory.

  2. If you want to clean the git directory, you can run:

    debuild clean
  3. Test with pbuilder:

    gbp buildpackage --git-pbuilder --git-ignore-new -j16

Rebuilding an existing debian source package

Like this:

apt-get source foo
cd foo-0.0.1
sudo apt-get build-dep foo
debuild -i -us -uc -b