Differences between revisions 1 and 22 (spanning 21 versions)
Revision 1 as of 2012-11-15 11:19:58
Size: 569
Editor: BartMartens
Comment: initial contents
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 1: Line 1:
<<TableOfContents>>
Line 3: Line 5:
 * Verify whether a fix is already in the bts.
 * Verify whether a fix is already [[http://qa.debian.org/watch/watchfiles/|here]]. The file names are package_eversion.watch with eversion = version without epoch but with Debian revision.
Line 6: Line 6:
 * Ask bartm or another DD from the qa team to add your debian/watch files (per 10 or so) in qa.debian.org:/srv/qa.debian.org/data/watch/watchfiles .  * 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 11: Line 12:

Check the [[debian/watch#Common_mistakes|common mistakes]] section of the [[debian/watch]] page.

<<Anchor(test)>>
== 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 [[http://qa.debian.org/watch/|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.

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.