How to help with fixing debian/watch files
- Write a good debian/watch file and test it with uscan.
Name it package_eversion.watch with eversion = version without epoch but with Debian revision. (Read here about epoch and Debian revision.)
Add it in the subversion repository of this Alioth project : https://alioth.debian.org/projects/sepwatch/
How to write a good debian/watch file
See "man uscan".
How to test the debian/watch file
By example pqiv 0.12-1:
- The file named "watch" contains this:
version=3 https://github.com/phillipberndt/pqiv/tags .*/archive/(\d\S*)\.tar\.gz
- Strip epoch and debian revision from the version. So 1:3.39-1 would become 3.39. In this case 0.12-1 becomes 0.12.
- Then use uscan like this (see "man uscan"), and verify whether the status makes sense:
uscan --watchfile watch --package pqiv --upstream-version 0.12 --no-download --verbose
- Then use uscan like this (see "man uscan"), and verify whether the link to the upstream file works:
uscan --watchfile watch --package pqiv --upstream-version 0 --no-download --verbose
List of debian/watch files with temporary or permanent problems
Here is the list of debian/watch files with temporary or permanent problems : http://qa.debian.org/watch/uscan-errors.txt
More reports are found here.
Removing separate watch files
Separate watch files can be removed the way they are added : via the subversion repository of this Alioth project : https://alioth.debian.org/projects/sepwatch/
There is usually no need to manually remove a separate watch file. The package maintainer can simply upload a new package with a fixed included debian/watch file. The notice on the PTS will automatically disappear.