From: Stefano Zacchiroli <zack@upsilon.cc>
Date: Tue, 26 Jun 2012 11:58:42 +0000 (+0200)
Subject: autopkgtest spec: document (XS-)Testsuite header
X-Git-Tag: debian/2.2.1~2
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=782a7a26e093c532e8ac7b226db0178f6eaeb620;p=autopkgtest.git

autopkgtest spec: document (XS-)Testsuite header
---

diff --git a/debian/changelog b/debian/changelog
index f109eb5..ada70ed 100644
--- 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 b83f7d0..94510c0 100644
--- 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.