autopkgtest spec: document (XS-)Testsuite header

diff --git a/debian/changelog b/debian/changelog
index f109eb59603d68750eb78dee110a8f915f3e15dc..ada70ed9097d8bb4077f537a78f5a462e24e36ee 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,11 @@
+autopkgtest (2.2.1) UNRELEASED; urgency=low
+
+  [ Stefano Zacchiroli ]
+  * specification: document (XS-)Testsuite source header
+    Closes: #679097
+
+ -- Stefano Zacchiroli <zack@debian.org>  Tue, 26 Jun 2012 13:55:31 +0200
+
 autopkgtest (2.2.0) unstable; urgency=low
 
   * Provide tests with ADTTMP rather than TMPDIR.

diff --git a/doc/README.package-tests b/doc/README.package-tests
index b83f7d0ef145a0a484371b21ddc710d31f6a8a21..94510c00386744a1bd2e07c4d767e92d684ab84a 100644 (file)
--- a/doc/README.package-tests
+++ b/doc/README.package-tests
@@ -128,3 +128,19 @@ The defined Restrictions are:
 
 
 There are no currently defined Features.
+
+
+Source package header
+---------------------
+
+To allow test execution environments to discover packages which provide tests,
+their source packages should have a `Testsuite:` header containing
+`autopkgtest` (which is currently the only defined value). Multiple values get
+comma separated, as usual in control files.
+
+This tag can be set manually in debian/control by adding
+
+    XS-Testsuite: autopkgtest
+
+in the `Source:` paragraph. Future versions of dpkg-source might add this
+automatically when a debian/tests/control file is present.