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.

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 bug555977-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug445203-rra

Add changelog and upgrading-checklist for #232448

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug232448-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.

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug232448-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 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 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 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 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 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 bug475101-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug509933-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug104373-rra

Add changelog entry for upgrading-checklist typo fix

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.

Use start-stop-daemon instead of kill for logrotate

Be clearer in the logrotate config text about postrotate purpose

It's not to get the daemon to re-read its configuration, but rather
to force it to reopen its log files.

Remove spurious whitespace change from patch

Merge branch 'master' into bug445203-rra

Avoid init scripts entirely in logrotate example

The best way to call the init script in a logrotate example is
debated and will be handled in another bug.  In the meantime, avoid
the problem entirely by not calling the init script.

Changelog and upgrading-checklist for #402721

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug475101-rra

Merge branch 'master' into bug477240-rra

Merge branch 'master' into bug445203-rra

Merge branch 'master' into bug402721-rra

Merge branch 'master' into bug104373-rra

Changelog and upgrading-checklist for #400322

Minor wording changes to control information files description

Architecture restrictions are supported for binary packages

Document architecture restrictions for binary relationship fields
as well as build relationships, with their limitation that they're
only valid in source package control files and are used to generate
the fields in the binary package.

Rephrasing of the rule for numeric signals in trap

Use invoke-rc.d in logrotate example

Use consistent terminology for control files

Introduce control information files, which refer to the members of
the control.tar.gz part of the .deb, and change terminology to be
consistent about that term, control files, and control fields.

Require /bin/sh support XSI extensions for kill and trap

Due to the widespread use of these extensions by scripts already in
the archive, require that /bin/sh support the XSI extensions for kill
and trap which permit kill -<signal> and use of numeric signals for
well-known signals.  Also permit trapping of SIGPIPE by signal number,
since this is done by well-known portable shell scripts like libtool.

Breaks/Conflicts should not be used unless necessary

State explicitly that Breaks and Conflicts should only be used where
needed, and should not be used if two packages merely provide similar
functionality.

Recommend logrotate config name, use missingok

Recommend that files installed in /etc/logrotate.d be named after
the package and use missingok in the example to demonstrate avoiding
errors if the package is removed but not purged.

Remove obsolete -D_REENTRANT requirement, ask for thread support

Remove the obsolete requirement that libraries be built with
-D_REENTRANT, as this no longer does anything significant in current
versions of glibc.  Instead, state directly that libraries should be
built with threading support and to be thread-safe if this is
supported.

Wording tweak to the shlibs.local description

Suggestion from Steve Langasek.

Merge branch 'master' into bug104373-rra

Add changelog and upgrading-checklist for #509932

Merge branch 'master' into bug509932-rra

Document the alternate SONAME format used by libtool -release

Document the SONAME format where the version number comes before
the .so and after a hyphen and provide another example.

Add changelog and upgrading-checklist for #218897