Differences between revisions 23 and 24
Revision 23 as of 2021-01-20 04:39:13
Size: 2293
Editor: ?LoganRosen
Comment: update information about finding watch files with problems
Revision 24 as of 2021-01-20 16:14:02
Size: 1598
Editor: PaulWise
Comment: 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".

Check the common mistakes section of the debian/watch page.

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")'