[PATCH 3/3] Document implicit test control file

[Antonio Terceiro]

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

diff --git a/doc/README.package-tests.rst b/doc/README.package-tests.rst
index 5f5556c..f5610a3 100644
--- a/doc/README.package-tests.rst
+++ b/doc/README.package-tests.rst
@@ -222,6 +222,58 @@ debian/control by adding
 
 in the ``Source:`` paragraph.
 
+Implicit test control file for known package types
+--------------------------------------------------
+
+There are groups of similarly-structured packages for which the contents
+of ``debian/tests/control`` would be mostly identical. For those
+packages, if ``debian/tests/control`` is ommited, an implicit control
+file is assumed.  Those packages do not have to provide anything else,
+although they should still include the appropriate source package header
+(``Testsuite: autopkgtest``) so that they can be discovered in the
+archive.
+
+The supported types of packages are documented below. For each type of
+package, it is listed the requirements that packages must meet to be
+detected as being of that given type, and the implicit contents that is
+assumed for their absent ``debian/tests/control``.
+
+Ruby packages
+.............
+
+**Requirements**:
+
+- the source package must contain at least one of the following files:
+  - ``debian/ruby-test-files.yaml``
+  - ``debian/ruby-tests.rb``
+  - ``debian/ruby-tests.rake``
+
+**Assumed control file**::
+
+    Test-Command: gem2deb-test-runner --autopkgtest 2>&1
+    Depends: @, gem2deb-test-runner
+
+Perl packages
+.............
+
+**Requirements**:
+
+- The source package must contain a ``t/`` directory; and
+- The source package must contain at least one of the following files:
+  - ``Makefile.PL``
+  - ``Build.PL``
+
+**Assumed control file:**::
+
+    Test-Command: /usr/share/pkg-perl-autopkgtest/runner build-deps
+    Depends: @, @builddeps@, pkg-perl-autopkgtest
+
+    Test-Command: /usr/share/pkg-perl-autopkgtest/runner runtime-deps
+    Depends: @, pkg-perl-autopkgtest
+
+    Test-Command: /usr/share/pkg-perl-autopkgtest/runner heavy-deps
+    Depends: @, pkg-perl-autopkgtest, pkg-perl-autopkgtest-heavy
+
 Reboot during a test
 --------------------
 
-- 
2.1.0