update information about finding watch files with problems
sepwatch is gone now, so send watch files to the maintainer
|Deletions are marked like this.||Additions are marked like this.|
|Line 6:||Line 6:|
| * Name it package_eversion.watch with eversion = version without epoch but with Debian revision. (Read [[http://www.debian.org/doc/debian-policy/ch-controlfields.html#s-f-Version|here]] about epoch and Debian revision.)
* Add it in the subversion repository of this Alioth project : https://alioth.debian.org/projects/sepwatch/
|* Submit it to the package maintainer via the BTS or salsa|
|Line 42:||Line 41:|
== 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.
How to help with fixing debian/watch files
- Write a good debian/watch file and test it with uscan.
- Submit it to the package maintainer via the BTS or salsa
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
The Ultimate Debian Database (UDD) has a script which outputs the upstream version status of all packages in Debian: https://udd.debian.org/cgi-bin/upstream-status.json.cgi
To filter to packages that have debian/watch files with temporary or permanent problems, you can use jq like so:
curl https://udd.debian.org/cgi-bin/upstream-status.json.cgi | jq '. | select(.status == "error")'