Merge branch 'master' into bug514919-rra

Order by section in upgrading-checklist

Drop another warning about using Breaks before stable dpkg supports it

* Breaks is now supported by the stable release of dpkg, so drop
  warnings against its use.  Thanks, Steve Langasek.  (Closes: #533577)

Breaks are supported in stable, so are now allowed in the archive

debian/rules: Fix a race condition while generating DEBIAN/md5sums.

Release policy 3.8.2.0

Add myself to Uploaders.
Update Standards-Version to 3.8.1 (no changes required).
debian/rules: use dpkg --print-architecture instead of
obsolete form dpkg --print-installation-architecture

debian/changelog: Closes: #533257

Colin build fix already addresses #533257

Add myself to Uploaders.

tidy up changelog ordering

State requirements for source package names. Closes: #525151

Build-depend on texlive-latex-extra, which is needed by debiandoc2latexps and isn't included in texlive's dependencies.

Spelling fixes

The FHS is the "Filesystem Hierarchy Standard", regardless of our
preferred spelling of "file system" elsewhere. Fix this and a nearby
search-and-replace capitalisation bug.

Move Speedo fonts into the deprecated category

The Speedo directory isn't part of the default X font path for a long
time, and libxfont in lenny disabled support for speedo fonts.

Closes #522218

Remove obsolete /var/mail transition requirement

Add changelog and upgrading-checklist for #522219

Remove /etc/X11/XF86Config-4 FHS exception

Correct earlier commit to wrong release.

Update changelog/checklist missed earlier re: #206684

Improve the wording of the section upgrading-checklist bullet

Update the list of archive sections from ftpmaster

Add GFDL 1.3 to the common-licenses list

Set the release date of the 3.8.1 upgrading-checklist entry

Closes: #519706

Mandate use of debconf or equivalent for user prompting.  See #206684.

Merge branch 'master' into bug514919-rra

Reference GPL-2 rather than the GPL symlink in debian/copyright

Finalize changes for 3.8.1.0

Remove the postinst and prerm scripts

doc-base registration is now handled by triggers and no longer required
and removal of /usr/doc links was completed long ago.

Build-Depend on texlive rather than tetex-extra

Build-Depend on texlive rather than tetex-extra.  texlive appears to
be sufficient for how Policy uses debiandoc-sgml and pulls in far
fewer packages.

Add changelog and upgrading checklist for #446712

Clarify that debian/control comments may not start with whitespace

The # must be in the first column.  Thanks to Adeodato Simó for the
wording suggestion.

debian/control files may contain comment lines

Document the debian/control comment syntax of lines starting with #,
including their behavior with multiline fields.  Based on wording by
Julien Cristau <jcristau@debian.org>.

Closes #446712.

Reorder upgrading-checklist to be in section order

/var/run and /var/lock may be volatile

/var/run and /var/lock may be mounted as temporary filesystems, and init
scripts must therefore create any necessary subdirectories dynamically.

Add changelog for #473439

Change two more "distribution areas" to "archive areas"

Thanks to Colin Watson for the review.

Merge branch 'master' into bug514919-rra

Merge branch 'master' into bug473439-rra

Add changelog and upgrading checklist for #513955

Reword footnote discussion of the testing distribution

Based on a suggestion by Adam D. Barratt.

Init scripts ending in *.sh aren't special

Remove the requirement of special handling of init scripts ending in *.sh.

Change distribution area to archive area

Also reword the footnote about the Social Contract language slightly.

No multiple distributions in Distribution, update footnote

Document that the Debian archive software does not allow listing
multiple distributions in the *.changes file.  Update the footnote
listing Distribution field values to list the ones currently used,
remove frozen, remove the discussion of testing, and add a mention
of stable-security and testing-security.

Based on wording proposed by Colin Watson and Adam D. Barratt.

Merge branch 'master' into bug473439-rra

Fully qualify all the menu sections in the menu policy

* Include the full name of each menu category rather than only the
  portion relative to the parent heading to be clearer in long category
  lists.  Thanks, Christoph Berg.  (Closes: #511804)

Merge branch 'master' into bug473439-rra

Add changelog and upgrading checklist for #470994

Merge branch 'master' into bug470994-rra

Merge branch 'bug163666-rra'

Add changelog for #163666

Wording fixes for architecture restriction clarification

Fix the wrong version number in the explanation text (thanks Emilio
Pozuelo Monfort) and potentially confusing wording (thanks Don
Armstrong).

Add .gitignore to ignore build products

Clarify handling of architecture restrictions in dependencies

Add an explanation of the example and an additional example and
explanation for handling of architecture restrictions within alternatives.
Thanks, Guillem Jover.  (Closes: #163666)

Adjust copyright extraction command for new tar behavior

* Add --wildcards to the sample tar command in appendix B.1 for
  extracting the package copyright file, adjusting for new tar option
  behavior.  Thanks, Yan Morin.  (Closes: #503685)

Reword maintainer script exit status requirement

* Reword the requirement that maintainer scripts exit with a zero
  status on success to avoid double-negatives.

Merge branch 'master' into bug473439-rra

Merge branch 'master' into bug470994-rra

Add changelog and upgrading checklist for #479080

Merge branch 'master' into bug473439-rra

Merge branch 'master' into bug479080-rra

Merge branch 'master' into bug470994-rra

Clarify debconf translation requirement and capitalization

Clarify that translation is only required for user-visible debconf
messages.  Capitalize "Debian Configuration Management Specification"
uniformly.  Thanks, Julian Andres Klode.  (Closes: #492624)

Mention debugging packages as an example of extra priority

Thanks, Charles Plessy.  (Closes: #491985)

Add changelog for #483418

Tweak the wording of mailbox permissions further

Fix a spelling error and try to provide more concrete guidance around
local system administrator configuration.  Thanks to Josip Rodin for
the wording review.

Merge branch 'master' into bug470994-rra

Also handle the abort-upgrade postrm case

When the diversion was added in a particular version of a package,
an aborted upgrade to a newer version with the diversion from an
older version without the diversion should remove the diversion when
rolling back to the older version.  Add the necessary postrm code and
explanation.  Thanks to Raphael Hertzog for the review.

Merge branch 'master' into bug483418-rra

Add changelog and upgrading checklist for #473019

Merge branch 'master' into bug473019-rra

Add changelog and upgrading checklist for #416450

Merge branch 'master' into bug416450-rra

Add changelog and upgrading checklist for #143941

Merge branch 'master' into bug143941-rra

Add changelog and upgrading checklist for #241333

Merge branch 'master' into bug483418-rra

Merge branch 'master' into bug473439-rra

Merge branch 'master' into bug479080-rra

Merge branch 'master' into bug470994-rra

Merge branch 'master' into bug473019-rra

Merge branch 'master' into bug416450-rra

Merge branch 'master' into bug241333-rra

Merge branch 'master' into bug143941-rra

Add changelog and upgrading checklist for #489460

Merge branch 'master' into bug479080-rra

Merge branch 'master' into bug473019-rra

Merge branch 'master' into bug416450-rra

Add a definitions section for ASCII and UTF-8

Change categories to distribution areas

Category is a term used only in the Policy manual.  dak uses component
and the Social Contract uses area.  Change the terminology to distribution
area everywhere and add a footnote explaining that dak also uses
component.

Closes: #473439

Tighten changelog format requirements and remove alternate formats

Tighten several changelog format requirements to a must and remove
the provision for alternative changelog formats, since the latter
is not permitted in the Debian archive.

Closes: #489460

Allow mailboxes to be either mode 600 or mode 660

Most mail systems these days do the mail delivery as the destination
user and for those systems the principal of least privilege indicates
that mailboxes should be mode 600.  Permit either permission scheme
and document the intent of both schemes in a footnote.

Closes: #470994

Clarify handling of diversions in maintainer scripts

Suggest running dpkg-divert unconditionally in the preinst to also
catch cases of upgrading a package from a version before the diversion
was added.  Suggest an alternate form that doesn't re-add the diversion
when unnecessary on upgrades.

In the postrm example, remove the diversion in more cases and document
why it should not be removed on upgrades.

Closes: #483418

Mandate UTF-8 for all control files

Closes: #143941

Mandate UTF-8 for changelog files

Remove the suggestion of UTF-8 in the appendix about changelog file
formats and add the requirement to the main Policy section on
debian/changelog.

Closes: #241333

Add changelog and upgrading checklist for #426877

Clarify what "sensible behaviour" is for init scripts

Clarify that sensible behavior for start includes not starting
another daemon and exiting successfully when the daemon is already
running.

Closes: #426877

Add nocheck build option to suppress build-time test suites

Closes: #416450

Clarify the definition and restrictions on Essential

Add a brief rationale for Essential to the section on Essential, moving
it from an earlier footnote.  Say that maintainers should take care in
adding any functionality to essential packages because it's very
difficult to remove such functionality later, moving some additional
text from the earlier footnote.

Closes: #479080

local must support multiple variables and assignment

All Bourne-type shells in Debian support localizing multiple variables
in one command, and all except posh support assignment.  Supporting
multiple variables and assignment brings the behavior of local in line
with export and readonly.  Permit /bin/sh scripts to assume that local
can take multiple variables and assignment.

Closes: Bug#473019

Use <user>:<group> instead of <user>.<group>

Use the newer <user>:<group> notation rather than <user>.<group>, which
is ambiguous for usernames containing periods and deprecated in chown.
Thanks to Kurt Roeckx for identifying instances in the Policy manual.