Bug#707851: Debian Menu Systems : Implementation of the TC decision

2015-09-22 Thread Sam Hartman 
> "Charles" == Charles Plessy  writes:

Charles> Le Mon, Sep 21, 2015 at 11:27:53AM -0400, Sam Hartman a
Charles> écrit :
>> Hi.  I've been debating how to respond to the shall vs must
>> thing.  The short answer is that there are reasons why you might
>> prefer shall, but I find that I'd rather say "must is good
>> enough," than try and come up with an articulate presentation of
>> the energy which would conclude by saying that if must still
>> seemed like the right choice go with it.
>> 
>> So, I'm fine with s/shall/must.

Charles> Thanks Sam,

Charles> the word "shall" appears only once in the Policy (quoted
Charles> below), so I think that avoiding it is consistent with the
Charles> Policy's style.

Nod, I think it was clear from your first message that this was your
argument.
I agree it's a valid position someone could take.

Bug#799779: integrate autopkgtest/DEP8 specification into debian-policy

2015-09-22 Thread Stefano Zacchiroli 
Package: debian-policy
Severity: wishlist
Tags: patch

I'm filing this bug report to avoid losing track of the discussion we've had in
July 2014 about merging the autopkgtest/DEP8 specification into Debian Policy.
The thread is archived starting from here:

  https://lists.debian.org/debian-policy/2014/07/msg00057.html

I've posted draft patches implementing what was discussed in the thread at the
time; I'm attaching them to this message as patches.

There have been some requested format changes (see thread), which I didn't have
time to implement. They're now up for grabs, hurry up! :-)

Cheers.

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (500, 'testing'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.1.0-2-amd64 (SMP w/4 CPU cores)
Locale: LANG=it_IT.utf8, LC_CTYPE=it_IT.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
>From 8440fe8b2bef5f99bddf3deb141a8c4b4b0354f9 Mon Sep 17 00:00:00 2001
From: Stefano Zacchiroli 
Date: Sun, 5 Oct 2014 23:41:40 +0200
Subject: [PATCH 1/2] autopkgtest: new specification for autopkgtest/DEP-8
 tests

---
 .gitignore |   4 +
 autopkgtest.desc   |  13 ++
 autopkgtest/Makefile   |  13 ++
 autopkgtest/autopkgtest.md | 305 +
 debian/control |   4 +-
 debian/rules   |  14 ++-
 6 files changed, 351 insertions(+), 2 deletions(-)
 create mode 100644 autopkgtest.desc
 create mode 100644 autopkgtest/Makefile
 create mode 100644 autopkgtest/autopkgtest.md

diff --git a/.gitignore b/.gitignore
index 5c80ed5..66b5940 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,5 +1,9 @@
 /Process.html
 /README.html
+/autopkgtest/version.txt
+/autopkgtest/*.expanded
+/autopkgtest/*.html
+/autopkgtest/*.txt.gz
 /copyright-format/copyright-format-1.0.html
 /copyright-format/version.xml
 /debconf_spec/debconf_specification.html
diff --git a/autopkgtest.desc b/autopkgtest.desc
new file mode 100644
index 000..dc7ea40
--- /dev/null
+++ b/autopkgtest.desc
@@ -0,0 +1,13 @@
+Document: autopkgtest
+Title: automatic as-installed package test specification
+Author: The Debian Project
+Abstract: Specification for automatic as-installed (AKA "autopkgtest",
+  or DEP-8) tests for Debian packages
+Section: Debian
+
+Format: text
+Files: /usr/share/doc/debian-policy/package-tests.txt.gz
+
+Format: HTML
+Index: /usr/share/doc/debian-policy/package-tests.html
+Files: /usr/share/doc/debian-policy/package-tests.html
diff --git a/autopkgtest/Makefile b/autopkgtest/Makefile
new file mode 100644
index 000..9552f38
--- /dev/null
+++ b/autopkgtest/Makefile
@@ -0,0 +1,13 @@
+all: autopkgtest.html autopkgtest.txt.gz
+
+autopkgtest.html: autopkgtest.md.expanded
+	markdown $< > $@
+
+autopkgtest.txt.gz: autopkgtest.md.expanded
+	gzip -cf9 $< > $@
+
+autopkgtest.md.expanded: autopkgtest.md version.txt
+	cat $^ > $@
+
+clean:
+	rm -f autopkgtest.html autopkgtest.txt.gz $(wildcard *.expanded)
diff --git a/autopkgtest/autopkgtest.md b/autopkgtest/autopkgtest.md
new file mode 100644
index 000..c9f6d77
--- /dev/null
+++ b/autopkgtest/autopkgtest.md
@@ -0,0 +1,305 @@
+Autopkgtest - Defining tests for Debian packages
+
+
+This document describes how the autopkgtest tester core (the program
+`adt-run`) interprets and executes tests found in Debian source
+packages.
+
+Overview
+
+
+The source package provides a test metadata file `debian/tests/control`.
+This is a file containing zero or more RFC822-style stanzas, along these
+lines:
+
+Tests: fred bill bongo
+Restrictions: needs-root breaks-testbed
+
+This example defines three tests, called `fred`, `bill` and `bongo`. The
+tests will be performed by executing `debian/tests/fred`,
+`debian/tests/bill`, etc. Each test program should, on success, exit
+with status 0 and print nothing to stderr; if a test exits nonzero, or
+prints to stderr, it is considered to have failed.
+
+The cwd of each test is guaranteed to be the root of the source package,
+which will have been unpacked but not built. *However* note that the
+tests must test the *installed* version of the program. Tests may not
+modify the source tree (and may not have write access to it).
+
+If the file to be executed has no execute bits set, `chmod a+x` is
+applied to it (this means that tests can be added in patches without the
+need for additional chmod; contrast this with debian/rules).
+
+During execution of the test, the environment variable `$ADTTMP` will
+point to a directory for the execution of this particular test, which
+starts empty and will be deleted afterwards (so there is no need for the
+test to clean up files left there).
+
+If tests want to create artifacts which are useful to attach to test
+results, such as additional log files or screenshots, they can put them
+into the directory