569
Comment: initial contents
|
2051
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. |
Contents
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.