From 5fe3ab754672330c5c3e41d25627483e07b1c0be Mon Sep 17 00:00:00 2001
From: Stefano Zacchiroli <zack@upsilon.cc>
Date: Mon, 25 Jun 2012 17:57:55 +0200
Subject: [PATCH] autopkgtest spec: document (XS-)Testsuite header

---
 doc/README.package-tests |   16 ++++++++++++++++
 1 file changed, 16 insertions(+)

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.
-- 
1.7.10

