Translation(s): none

New upstream Release

How to upgrade to a new upstream version. You can check for it regulary here:

Main workflow

If you got a correct debian/watch file and there are no problems, you can use uscan. First make sure you got a local repository from alioth which has the pristine-tar branch:

gbp-clone --pristine-tar <your-alioth-account><pkg-name>.git

or if you are using the newer version of git-buildpackage

gbp clone --pristine-tar <your-alioth-account><pkg-name>.git

Now use uscan:

git import-orig --pristine-tar --uscan

or if you are using the newer version of git-buildpackage

gbp import-orig --pristine-tar --uscan

Then try to build the package like usual and make corrections and changes which are needed. You will have to edit debian/changelog. Use dch for it, it will give you a template:

dch -v <new-upstream-version>-1

Replace "UNRELEASED" with "unstable" and insert this as the first entry:

  * New upstream Release

Common problems

import from github

If upstream from rubygems is missing folders (test, spec, README, etc) point debian/watch to github (assuming there is the solution. Often there is the solution. It is a tricky problem. Make a backup of your directory, double check everything. Correct wrong info here. Boutil explained it in IRC, thanks to him.

Go to your build directory,top level and delete all old tarballs, then go in the source folder:

cd ~/Build/build-minimagick
rm -r *tar.gz
cd ruby-mini-magick

Edit the file debian/watch and point it to github. Use this content and adapt the path for github:

opts=uversionmangle=s/(\d)[_\.\-\+]?((RC|rc|pre|dev|beta|alpha|b|a)\d*)$/$1~$2/,dversionmangle=s/\+(debian|dfsg|ds|deb|gh)\d*$// \ .*/v?(\d[\d\.]+)\.tar\.gz

Make sure to add gh for dversionmangle if you copy from somewhere else. Run uscan to test if you got the syntax right, then import the new tarball

uscan --verbose --report

uscan --force-download

and import the upstream version from github

git  import-orig --pristine-tar ../*tar.gz

When you are asked for the version, add +gh to it


and make sure to use it in debian/changelog too, when using dch:

dch -v 3.6.0+gh-1

You may run into further trouble. Try "git tag" (i had to remove the tag pristine-tar, as an example).

Non-Maintainer Upload

If you are not the maintainer of the package but wish to update it, check if it is being maintained in the pkg-ruby-extras team, if so then you can follow the steps listed above to build the package.

When making changes to debian/changelog add the following line :

 * Team Upload

See ruby-configurate for example.

By adding Team Upload, lintian will not give warnings about NMU and NMU version format