Differences between revisions 3 and 4
⇤ ← Revision 3 as of 2008-01-29 16:36:36 →
Size: 2758
Editor: RaphaelGeissert
Comment:
← Revision 4 as of 2008-01-29 20:05:00 → ⇥
Size: 3984
Editor: RaphaelGeissert
Comment: Changed the style and added some more information
Deletions are marked like this. Additions are marked like this.
Line 11: Line 11:
== Introduction ==
Line 13: Line 15:
 Query Packages status :: The DEHS data of a package is available with other QA metrics on [http://packages.qa.debian.org] (It's also available on [http://dehs.alioth.debian.org]).  Query packages status :: The DEHS data of a package is available with other QA metrics on [http://packages.qa.debian.org], but it is also available on [http://dehs.alioth.debian.org].
Line 15: Line 17:
 Notify Maintainer :: DEHS can send notifications of new upstream version to the 'summary' tag/keyword of the PTS when it finds a new upstream version. [[BR]] Anyone interested in receiving this kind of notifications please see the  [http://www.debian.org/doc/manuals/developers-reference/ch-resources.en.html#s-pkg-tracking-system PTS' documentation] on how to subscribe.  Maintainer report :: DEHS is also integrated on the ["qa.debian.org/DDPO"] page of each maintainer. On this view the latest upstream version is visible in a per package basis on the table.

 Notify Maintainer :: DEHS can send notifications of new upstream version to the 'summary' tag/keyword of the PTS when it finds a new upstream version. [[BR]] Anyone interested in receiving this kind of notifications please see the [http://www.debian.org/doc/manuals/developers-reference/ch-resources.en.html#s-pkg-tracking-system PTS' documentation] on how to subscribe.
Line 19: Line 23:
= How DEHS works = == How DEHS works ==
Line 22: Line 27:
Basically, DEHS is doing this almost every day on the whole [:DebianUnstable:Debian/Unstable] (and [:DebianExperimental:Debian/Experimental] ?) archives. (Actually, Dehs checks upstream every four days, AND every time a new version of a given package is introduced in Debian). Basically, DEHS is doing this almost every day on the whole [:DebianUnstable:Debian/Unstable] (and [:DebianExperimental:Debian/Experimental] ?) archives. (Actually, DEHS checks upstream about every four days, AND every time a new version of a given package is introduced in Debian).
Line 24: Line 29:
DEHS, also has an intelligent mechanism to ''guess'' the location of a program. (Todo : Describe how). DEHS, also has an intelligent mechanism to ''guess'' the location of a program, this is known as the ''Watch Wizard''. It works by extracting the urls from the copyright file of packages without a watch file. Afterwards it makes several attempts to guess the file name and file extension which would be displayed on that url.
Line 26: Line 31:
== Extraction of watch files ==
Line 27: Line 33:
= More info = DEHS gathers the watch files by downloading the .diff.gz file of a given package proceding by extracting the debian/watch file from it.
This means that native and packages which contain the debian/watch file inside the .orig.tar.gz aren't processed by DEHS.

== Future features ==

 Watch file injection :: At the moment it is not possible to ''inject'' a watch file on DEHS database. But by request there might be some kind of implementation in the future.

 Checking of Homepage and Vcs-browser :: It is planned to make DEHS check the validity of the Homepage and Vcs-browser control fields.

== Bugs, features, etc ==

Bugs and feature requests are filled against the Bug:qa.debian.org pseudo-package on the BTS.

== Other information ==
Line 29: Line 49:
 * Dehs source code is now available on svn://svn.debian.org/dehs ([http://svn.debian.org/viewcvs/dehs/ browse]).  * DEHS source code is available on svn://svn.debian.org/dehs ([http://svn.debian.org/viewcvs/dehs/ browse]).
Line 31: Line 51:
= See Also = == See Also ==

Debian External Health Status (DEHS)

Introduction

DEHS is a service that periodically checks packages for new upstream version. This service is part of Debian QA (Quality Assurance) project.

Query packages status

The DEHS data of a package is available with other QA metrics on [http://packages.qa.debian.org], but it is also available on [http://dehs.alioth.debian.org].

Maintainer report
DEHS is also integrated on the ["qa.debian.org/DDPO"] page of each maintainer. On this view the latest upstream version is visible in a per package basis on the table.
Notify Maintainer

DEHS can send notifications of new upstream version to the 'summary' tag/keyword of the PTS when it finds a new upstream version. ?BR Anyone interested in receiving this kind of notifications please see the [http://www.debian.org/doc/manuals/developers-reference/ch-resources.en.html#s-pkg-tracking-system PTS' documentation] on how to subscribe.

DEHS statistics

DEHS provides a [http://dehs.alioth.debian.org/stats.html statistics page] which show the overall "external status" of Debian over the time.

How DEHS works

Debian packages optionally provides the location where upstream sources are released (this is known as debian/watch file). Using an appropriate tool (like uscan from devscripts), it's possible to automatically check the latest upstream version of a program.

Basically, DEHS is doing this almost every day on the whole [:DebianUnstable:Debian/Unstable] (and [:DebianExperimental:Debian/Experimental] ?) archives. (Actually, DEHS checks upstream about every four days, AND every time a new version of a given package is introduced in Debian).

DEHS, also has an intelligent mechanism to guess the location of a program, this is known as the Watch Wizard. It works by extracting the urls from the copyright file of packages without a watch file. Afterwards it makes several attempts to guess the file name and file extension which would be displayed on that url.

Extraction of watch files

DEHS gathers the watch files by downloading the .diff.gz file of a given package proceding by extracting the debian/watch file from it. This means that native and packages which contain the debian/watch file inside the .orig.tar.gz aren't processed by DEHS.

Future features

Watch file injection

At the moment it is not possible to inject a watch file on DEHS database. But by request there might be some kind of implementation in the future.

Checking of Homepage and Vcs-browser
It is planned to make DEHS check the validity of the Homepage and Vcs-browser control fields.

Bugs, features, etc

Bugs and feature requests are filled against the qa.debian.org pseudo-package on the BTS.

Other information

See Also