Initial thoughts
----------------

All packages should install their tests as one of:

  /usr/lib/debian-test/tests/<package-name>

or

  /usr/lib/debian-test/tests/<package-name>/test-*

The second form being used where there multiple test programs, or for
when there are other support files that need somewhere to live, which
will be put in the same directory.

---

All tests that are part of ``debian-test'' will be put under either:

  /usr/lib/debian-test/tests/debian-test/
or
  /usr/lib/debian-test/default-tests/<package-name>

to avoid name conflicts.

The tests under tests/debian-test will be cross-package general health
checks, whereas the tests under default-tests will be run only if
there is not a file/directory of the same name under tests.

In other words, the tests under tests/debian-test are here to stay,
while the tests under default-tests are expected to end up being
included in their respective packages, at which point they will be
dropped from debian-test.

---

The main script should take the following options/parameters:

  -q generate no output
  -s generate a summary (default)
  -v generate verbose output
  -i allow interaction
  -m mail the results to some @debian.org address for automatic processing

Since it can deal with -q itself (> /dev/null) there is no need for
test script authors to worry about that.

I think the tests should always be written to produce verbose output.
The test script needs to be able to discard some or all of this verbose
output in order to implement the -v|-s|-q options, so it must be in a
standard format.

I suggest that each test be delimited in some way, to allow for
automatic processing.  Here's an initial suggestion:

debian-test TESTING: <description of feature>
blurb about test
which can be thrown away
if in summary mode
debian-test MESSAGE: text that will be kept, even in summary mode
more verbose drivel
debian-test RESULT: <description of feature>: [PASSED|FAILED]

The scripts need only to understand the -i option, and only if they
wish to be interactive.

