Release policy 3.9.7.0

debian/rules: no more ship libc6-migration.txt

Proposed by Julian Gilbey. Closes: #797478

Fix FTBFS and migrate to openjade/opensp

debian/control, Makefile:
 - add missing Build-Depends on sp (opensp). Closes: #812663
 - migrate to openjade and opensp.

autopkgtest.desc: replace reference to packages-tests by autopkgtest

autopkgtest: new specification for autopkgtest/DEP-8 tests

Use gzip -n for compressing generated files.

debian/rules: dpkg-gencontrol: remove useless -isp

Recommendation for additional documentation

Policy: [12.3] recommend to ship additional documentation for package 'pkg'
in a separate package 'pkg-doc' and install it into /usr/share/doc/pkg.

Wording:  Russ Allbery <rra@debian.org>
Seconded: Bill Allombert <ballombe@debian.org>
Seconded: Charles Plessy <plessy@debian.org>
Closes: #106073

Some further wording tweaks to additional documentation

Weaken the documentation location to "should" to match previous
behavior.  Change the example of text documentation from TODOs to
FAQs.  Clarify that documentation should be installed elsewhere if
it is used or read by programs, rather than using the ambiguous
term "referenced."

Further overhaul of the additional documentation section

Building on top of Ben's patch, this includes the following changes:

* Shared library documentation is called out as a special case of the
  general rule that documentation should be packaged separately if it's
  large, recommending installing documentation of any appreciable size in
  the development package or a separate documentation package rather than
  the shared library package.

* The naming convention for documentation packages (package-doc or
  package-doc-language) is explicitly stated (but is not a requirement).

* package-doc is allowed to put documentation in either
  /usr/share/doc/package or /usr/share/doc/package-doc, but the former is
  preferred.  package-doc still has to install its own mandatory
  documentation files (changelog, copyright) in
  /usr/share/doc/package-doc.

* The paragraph about /usr/doc is removed.

* Some reorganization and wording tweaks to hopefully make things clearer.

Recommend <package> documentation go in /usr/share/doc/<package>

Recommend that <package> documentation be installed into
/usr/share/doc/<package> even if it's packaged separately.

Closes: #106073

upgrading-checklist.sgml: fix typo in previous patch

Policy: [4.9] debian/rules: required targets must not attempt network access.

Wording:  Bill  Allombert <ballombe@debian.org>
Seconded: Andrey Rahmatullin <wrar@debian.org>
Seconded: Lucas Nussbaum <lucas@debian.org>
Closes: #770016

Document that empty field values are only allowed in debian/control.

Policy: [5.1] empty field values in control files are only permitted in
the debian/control file of a source package.
Wording:  Bill Allombert <ballombe@debian.org>
Seconded: Henrique de Moraes Holschuh <hmh@debian.org>
Seconded: Andrey Rahmatullin <wrar@debian.org>
Closes: #666726

Policy: [9.2.2] document 32-bit uids

Wording: Matthew Vernon <matthew@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Bill Allombert <ballombe@debian.org>
Seconded: Julien Cristau <jcristau@debian.org>
Closes: #765499

Policy: Symbolic links must not traverse above the root directory.

Wording: Andrey Rahmatullin <wrar@debian.org>
Seconded: Bill Allombert <ballombe@debian.org>
Seconded: Jakub Wilk <jwilk@debian.org>
Seconded: Henrique de Moraes Holschuh <hmh@debian.org>
Closes: #555979

Policy: refreshed the names of the Policy Editors.

Bump version to 3.9.7.0

Merge branch 'master' of ssh://git.debian.org/git/dbnpolicy/policy

Reset version to 3.9.6.1

Process.org: Do the same

README.org: comment out emacs mode line.

Another apparent change in the org-mode exported causes this to show
up in the output.

README.org: move latex header stuff to external file

Apparently these TeX macros were previously ignored, but they are not
any longer.

Makefile: update for new org function names in org 8.2

Emacs 24.4 includes an updated org-mode, which changes the export framework quite a lot.

This patch also stops sending errors and warnings to /dev/null, in
order to help with debugging.

Add more versions of the Creative Commons licenses in tools/license-count.

Add MPL-2.0 to tools/license-count.

Bump version to 3.9.7.0

Release policy 3.9.6.0

debian/control: now Build-Depends on emacs-nox|emacs

Policy: Change default web document root to /var/www/html

Wording: Bill Allombert <ballombe@debian.org>
Seconded: Arno Töll <arno@debian.org>
Seconded: Matthias Urlichs <matthias@urlichs.de>
Closes: #491547

Update upgrading-checklist.sgml

Policy: Clarify whose signature should go in debian/changelog (4.4)

Wording: Russ Allbery <rra@debian.org>
Seconded: Andrew McMillan <andrew@morphoss.com>
Seconded: Gregor Herrmann <gregoa@debian.org>
Closes: #593611

policy.sgml 9.1.1: Remove 'the planned development of' before multiarch

virtual-package-names-list.txt: Add httpd-wsgi

Wording: Bill Allombert <ballombe@debian.org>
Seconded: Jonas Smedegaard <dr@jones.dk>
Seconded: Piotr Ożarowski <piotr@debian.org>
Closes: #588497

virtual-package-names-list.txt: update java-runtime list

Added java{5,6,7,8,9}-runtime{,-headless}
Removed java1-runtime, java2-runtime

Wording: Emmanuel Bourg <ebourg@apache.org>
Seconded: Tony Mancill <tmancill@debian.org>
Seconded: Bill Allombert <ballombe@debian.org>
Closes: #754876

Build-Depends on emacs24-nox|emacs24 instead of emacs23.

Closes: #753999 Thanks Gabriele Giacone.

Policy: [5.6.21] Files: Fix typo "by" -> be.

Wording: Benedikt Wildenhain.
Closes: #753353.

Fix typo in latest entry reported by Niko Tiny

Perl Policy: Packages using Perl vendorarch directory need a perlapi-* dependency

Wording: Niko Tyni <ntyni@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Gregor Herrmann <gregoa@debian.org>
Seconded: Axel Beckert <abe@debian.org>
Closes: #750017

All packages using Perl vendorarch directory need a perlapi-* dependency

Having $Config{vendorarch} change between Perl major versions (for
multiarch or other reasons) implies that packages using it need a strict
dependency on those versions of perl-base that have a compatible search
path (@INC).

The vast majority of these packages are binary ("XS") modules, where we
already require a dependency on the virtual package perlapi-*, provided
by perl-base. The name of this virtual package will change when the
interface between the Perl interpreter and the modules changes.

If we consider @INC part of that interface, we can use the existing
mechanism also for the few nonbinary modules using $Config{vendorarch}.
This is a new requirement that currently affects six packages in
the archive.

Perl Policy: @INC changes for multiarch

Wording: Niko Tyni <ntyni@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Damyan Ivanov <dmn@debian.org>
Closes: #748380

Recommend $Config{vendorarch} et al. over hardcoding @INC locations

The most pressing need for this is for including the multiarch
triplet in vendorarch, but it is also a logical continuation for the
$Config{debian_abi} concept introduced earlier.

If we ever have to make a binary incompatible change without a major
version bump, we'll probably have to change @INC too, at least for
locally installed binary modules (sitearch).

Policy: Discourage statically linked binaries

Wording: Russ Allbery <rra@debian.org>
Seconded: Bill Allombert <ballombe@debian.org>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Closes: #555980

Policy: Grant an FHS exception for the multiarch headers directories

Wording Bill Allombert <ballombe@debian.org>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Russ Allbery <rra@debian.org>
Closes: #742756

Perl Policy: Explain %Config earlier

Move the footnote about the Config module to the first reference
The new Config reference was introduced in cc34dcc0 but the
footnote wasn't moved accordingly.

Wording: Niko Tyni <ntyni@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Damyan Ivanov <dmn@debian.org>
Closes: #748479

Document that @INC has /usr/lib/perl/5.18, not /usr/lib/perl/5.18.2

Since at least 5.8.4-8 (Debian sarge release), the Perl search
path for the core modules has used the major version (5.18)
instead of the full one (5.18.2).

lib<qual>: gives an example of what <qual> is

Wording by Jonathan Nieder: add
(where lib<qual> is a variant of lib such as lib32 or lib64)

Policy: Relax FHS requirement about when /usr/local/lib<qual> should exist.

Wording: Tollef Fog Heen <tfheen@err.no>
Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Russ Allbery <rra@debian.org>
Closes: #613143

Policy: Relax /usr/share FHS requirement for directories with mixed content.

Wording: Joey Hess <joeyh@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Julien Cristau <jcristau@debian.org>
Seconded: Jakub Wilk <jwilk@debian.org>
Seconded: Michael Biebl <biebl@debian.org>
Closes: #741304

Remove Charles from Uploaders

Charles has resigned as Policy editor in October.

Policy: Remove reference to DEHS (dead service)

Wording: David Prévot <taffit@debian.org>
Seconded: Julian Gilbey <julian@d-and-j.net>
Seconded: Charles Plessy <plessy@debian.org>
Closes: #731810

Fix use of metasyntactic variable in [11.5.1] Web servers and applications

Closes: #737730. Thanks Olivier Berger.

upgrading-checklist.sgml: remove spurious 'details in'

The details in are left overs from the HTML transition.  Closes: #740100.
Thanks Jakub Wilk.

Revert premature merge of bug707851-plessy by Charles Plessy

Merge branch 'bug707851-plessy'

Changelog and checklist entries for #707851.

Document the FreeDesktop menu entries and media type declarations.

The Debian menu is optionally supported.

Wording: Charles Plessy <plessy@debian.org>
Seconded: Lisandro Damián Nicanor Pérez Meyer <perezmeyer@gmail.com>
Seconded: Cyril Brulebois <kibi@debian.org> (for the menu entries)
Seconded: Russ Allbery <rra@debian.org>
Closes: #707851

debian-policy (3.9.5.0) unstable; urgency=low

Conforms with Itself.

Packaging: refreshed the names of the Policy Editors.

Packaging: normalised debian/control with the tool "config-model-edit".

Packaging: use the VCS URLs proposed by Lintian.

Policy: Control data fields must not start with a hyphen character.

Wording: Niels Thykier <niels@thykier.net>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Guillem Jover <guillem@debian.org>
Closes: #706778

Policy: on upgrades, recommend removing obsolete unchanged conf. files.

Wording: Paul Wise <pabs@debian.org>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Charles Plessy <plessy@debian.org>
Closes: #707077

Policy: Remove the exception to the FHS for the /selinux directory.

Wording: Charles Plessy <plessy@debian.org>
Seconded: Steve Langasek <vorlon@debian.org>
Seconded: Julien Cristau <jcristau@debian.org>
Closes: #707183

Changelog and checklist entries for #720507.

Document the Dgit field for Debian Source Control files.

Wording: Ian Jackson <ijackson@chiark.greenend.org.uk>
Seconded: Charles Plessy <plessy@debian.org>
Seconded: Joey Hess <joeyh@debian.org>
Seconded: Dmitrijs Ledkovs <xnox@debian.org>
Closes: #720507

Corrected syntax error.

virtual-package-names-list: removed mp3-decoder.

Seconded: Kurt Roeckx <kurt@roeckx.be>
Seconded: Charles Plessy <plessy@debian.org>
Closes: #668394

Changelog and upgrading checklist for #701081.

Policy: File names encoded in UTF-8. ASCII preferred and mandatory in PATH.

Wording: Charles Plessy <plessy@debian.org>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Julian Gilbey <julian@d-and-j.net>
Closes: #701081

virtual-package-names-list: removed mp3-encoder.

Seconded: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Charles Plessy <plessy@debian.org>
Closes: #668394

Clarify what is meant by "compressed" in section 10.5.

Closes: #676784

Policy: Stop recommending to serve HTML documents from /usr/share/doc.

Wording: Thomas Goirand <zigo@debian.org>
Seconded: Charles Plessy <plessy@debian.org>
Seconded: Jonathan Nieder <jrnieder@gmail.com>
Closes: #715804

Clarify occurences of 'unpacked' and 'installed'.

This is related to #705403

Changelog entry for #705403

Replaced non-standard names of dpkg states by normalised ones.

Closes: #705403

List build-arch and build-indep with the other required targets in 4.9.

Closes: #704657
Thanks: Philipp Hahn

Changelog for #703022.

Do not attempt to divert a conffile.

Future version of dpkg will better support diversion of conffiles.  At that
time, this warning can be removed.

Closes: #703022

Changelog and upgrading-checklist for #669915

Policy: install-info is run by a dpkg trigger.

Wording: Jonathan Nieder <jrnieder@gmail.com>
Seconded: Charles Plessy <plessy@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Closes: #669915

Changelog entry for the previous commit.

Correct cut-paste typo by replacing 'symbols' with 'shlibs'.

Thanks: Salvatore Bonaccorso <carnil@debian.org>
See: #688220

Not closing the bug as it later evolved on addressing the deprecation
of 'dpkg-query --control-path'.

Delegate udeb policy description to d-i internals manual

Closes: #698030

Changelog entry for the work in progress in #598645.

Delegate deb(5) format description to the man page

The information in this section is in any case not very complete,
and covered already in way more detail by the man page.

Switch appendix section for dpkg-buildpackage into a stub

The section only documents things already present in the man page,
and in cases the documentation is outdated. Just turn it into a stub
pointing to the man page, to avoid renumbering issues.

Replace appendix sections by stubs.

(Replaces Guillem's patch "Remove appendix sections for dpkg-genchanges,
dpkg-parsechangelog and dpkg-architecture")

Refer to the dpkg man pages for programs not described in the appendices

This will allow to progressively remove specific program sections, that
have been either integrated into the policy or the dpkg documentation.

Document Debconf's escape capability.

Closes: #671355.

Changelog for #700574.

Remove outdated mention of dselect documentation

There's no description in the appendices of the dselect access methods.

Changelog and upgrading-checklist for #697433.

Description of the Package-List field.

Closes: #697433

Changelog for #700536

Update dak reference from old katie name

Closes: #700536

Updated following the delegation of October 2012.

See: https://lists.debian.org/debian-devel-announce/2012/10/msg00006.html

Changelog and upgrading-checklist for #679326

Policy: Obsolete the DM-Upload-Allowed field.

Wording: Charles Plessy <plessy@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Ansgar Burchardt <ansgar@debian.org>
Seconded: Guillem Jover <guillem@debian.org>
Closes: #679326
See: http://lists.debian.org/87vcf6lbw4.fsf@deep-thought.43-1.org