Finalize changes for 3.9.1.0

Add changelog entry for changelog first line footnote

Reformat information about first changelog line

Mention optional special role for the first changelog line

Points at the Debian Developer's Reference, that documents standardised
changelog first entries for NMU, QA, security and team uploads.

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug504880-rra

Changelog and upgrading-checklist for #555977

Merge branch 'master' into bug555977-rra

Changelog and upgrading-checklist for #477240

Merge branch 'master' into bug477240-rra

Changelog and upgrading-checklist for #445203

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug445203-rra

Add changelog and upgrading-checklist for #232448

Really fix the pre-depends wording

Based on feedback from Ben Finney.

Incorporate maintainer script updates from Jonathan Nieder's review

Clarify and in some cases fix the summaries of what maintainer scripts
can rely upon based on a comprehensive review from Jonathan Nieder,
and include a wording fix from Ben Finney.

Add detailed breakdown of what maintainer scripts can assume

For each possible action in a maintainer script, state what the
maintainer script can assume in that case.  Remove references to
using Pre-Depends for controlling what's available during package
removal.  Be clear that no postrm actions can rely on dependencies
being available.  Remove references saying that prerm can rely on
dependencies being configured.

Based on extensive analysis by Ian Jackson.

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug232448-rra

Merge branch 'master' into bug504880-rra

Only dpkg-gencontrol supports variable substitution

dpkg-genchanges and dpkg-source don't use substvars, so stop claiming
that they do.  Wording from Charles Plessy.

Orphaning of unmaintained packages is a should

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug232448-rra

Merge branch 'master' into bug459868-rra

Changelog and upgrading-checklist for #509933

Merge branch 'master' into bug509933-rra

Specify ownership and permission for control information files

Add changelog for control information file terminology fix

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug232448-rra

Changelog and upgrading-checklist for #184064

Merge branch 'master' into bug184064-rra

Require GNAT *.ali files to be installed read-only

GNAT requires *.ali files to be read-only or it will attempt to
recompile them when used.

Fix typo in prgn tag

Alternatives should have slave alternatives for manual pages

Require that the alternatives for editor, pager, x-terminal-emulator,
and x-window-manager have slave alternatives pointing to the appropriate
manual page.

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug186102-rra

Changelog and upgrading-checklist for #186102

Add changelog for formatting error fix

Fix formatting error in footnote to 7.7

Add a script to generate a report of Policy bugs

Revise the section discussing version numbers based on dates

State the important requirement (year, month, date, all numeric)
and confine the discussion just to the date portion of the version
number.  Don't require that Debian packages avoid punctuation in
the date, but caution against use of -.

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug445203-rra

Changelog and upgrading-checklist for #104373

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug104373-rra

Changelog and upgrading-checklist for #475101

kill extensions must only be supported if it's a built-in

Otherwise, coreutils will take care of it.

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug475101-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug104373-rra

Revert "Clarify the banned dependencies between main and non-main"

This reverts commit 30daa4aab845a7972bff3f0e33994176bc912dc6.  Bill
Allombert objects to this change, so we'll do it through the
normative process.

Conflicts:

debian/changelog

Fix typo in new shared library wording

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug504880-rra

Merge branch 'master' into bug475101-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug459868-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug104373-rra

Add changelog entry for upgrading-checklist typo fix

Improve wording around package orphaning

Wording suggestion from Steve Langasek.  Also fix another wording
choice.

Shared library wording updates

Update the wording of the proposed patch based on suggestions from
Raphael Hertzog and Steve Langasek.  Remove the footnote discussing
shared libraries without versioning information, since they're not
Policy-compliant in other ways and are all weird special cases.
Rephrase the footnote about shared library file naming conventions.
Add a reference to the deb-symbols man page.

Overhaul the documentation of shared library SONAMEs

Provide much more background information about shared library
versioning and how the different symlinks are used.  Clearly
require the SONAME and corresponding binary package name to be
changed if the library ABI changes.  Add more cautions to the
practice of bundling multiple shared libraries together in one
package.  Clarify that the shared library section does not
apply to private libraries and loadable modules.