Differences between revisions 21 and 22
Revision 21 as of 2013-07-11 06:27:23
Size: 2575
Editor: BartMartens
Comment: continued editing "Removing separate watch files"
Revision 22 as of 2013-07-13 19:10:44
Size: 2051
Editor: BartMartens
Comment: svn
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
 * Add your watch file using one of two methods:
  * Upload the watch file using [[http://qa.debian.org/watch/uploadwatch.php|this web form]]. Please include your name, email address and the current date so we can give you credit and or feedback. Your submission will be reviewed by a member of the QA team and accepted, fixed, rewritten or rejected as appropriate.
  * Ask bartm@debian.org or another DD from the QA team to add your debian/watch files in qa.debian.org:/srv/qa.debian.org/data/watch/watchfiles. The file names are 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.)
 * 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/
Line 43: Line 42:
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/
Line 44: Line 45:

If the separate watch file contains a mistake, then please contact the author of the separate watch file. If that author cannot be reached, then please contact the QA team. The separate watch files are located in qa.debian.org:/srv/qa.debian.org/data/watch/watchfiles .

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".

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

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.