Merge branch 'master' into bug555977-rra

Changelog and upgrading-checklist for #104373

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug104373-rra

Changelog and upgrading-checklist for #475101

Merge branch 'master' into bug555977-rra

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

Merge branch 'master' into bug555977-rra

Merge branch 'master' into bug475101-rra

Merge branch 'master' into bug104373-rra

Add changelog entry for upgrading-checklist typo fix

Changelog and upgrading-checklist for #402721

Merge branch 'master' into bug555977-rra

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

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.

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.

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

Remove obsolete shlibs.local information

Remove the instructions for how to create shlibs.local files and the
encouragement to do so if one runs into errors with dpkg-shlibdeps, since
the archive coverage for shlibs is now complete and writing a shlibs.local
file is unlikely to be an appropriate solution to one's problem.

Reformat and update the shlibs section

* Revise the footnote discussing shlibs creation to not talk about the
  switch to objdump as if it were a new innovation and to explicitly
  mention the NEEDED attribute as the source of dependency information.

Also fix markup, formatting, indentation, and phrasing in multiple
places.

Merge branch 'master' into bug218897-rra

Merge branch 'master' into bug104373-rra

Add changelog and upgrading-checklist for #561413

dpkg-divert --package is only required when adding or removing

Forbid dpkg-divert --local in package maintainer scripts

State that package maintainer scripts must use --package and must
not use --local when invoking dpkg-divert.

Rewrite requirements around libtool .la file handling

State that .la files should normally not be included in Debian
packages, with special exceptions for libraries loaded by libltdl and
for .la files on which other .la files may depend.  State that
dependency_libs should be emptied if the .la files have to be
retained.  Exclude non-public libraries and loadable modules from
these requirements.

Merge branch 'master' into bug104373-rra

Clarify the banned dependencies between main and non-main

* Add Pre-Depends and Build-Depends-Indep to the relationships not
  allowed from main to contrib or non-free and mention that such
  relationships are okay if the non-free package is only an
  alternative.  Thanks, Raphael Geissert.  (Closes: #587279)

Include GPL version 1 in common-licenses

Closes Bug#436105.

Fix typos in upgrading-checklist

Better explanation of the Perl module naming policy

* Explain the Perl module package naming policy more explicitly and
  provide some examples.  (Closes: #175202)

Set the Perl Policy version to match the package version

* Set the version of the Perl Policy to match the version of the Policy
  package.

Switch to source format 3.0 (native)

Finalize release for 3.9.0.0

Add changelog and upgrading-checklist for #547272

Merge branch 'master' into bug104373-rra

Further minor updates around the Format field description

Be clear which control files consist of a single paragraph and use
consistent terminology.  Be more consistent about <file> markup.  Use
an SGML entity for the .changes file version to avoid repeating it.

Remove a stray misplaced paragraph from merging original patch

Further revisions to the Format update

Drop historical information about the version changes in .changes
files.  It doesn't seem useful at this point.  Specify the format
of Format for source packages separately since referring to the
version format with exceptions and additions is more confusing and
it's not really a version in the same sense.  Add the full list of
supported source package formats in a footnote.  Add a bit more
explanation for how the source package format is used.

Clarification of the Format field in control files -- patch for #547272.

The Format field has a different meaning for Debian source control files and
Debian changes files. This patch :

 - documents the use and syntax of the Format field for these two types
   of control files.

 - Specifies the format 1.8 of Debian changes files, adds descriptions for
   the Checksums-Sha1 and Checksums-Sha256 files, and provides some history
   for the Closes, Changed-By and Maintainer fields.

Bump revision for the next release

Add changelog and upgrading-checklist for #578854

Merge branch 'master' into bug578854-rra

Add bug closer for SETTITLE

Document debconf SETTITLE command

Document the SETTITLE command in the debconf policy.  Inclusion of this
command should not pose any problems as it has been supported since 2003
(debconf version 1.3.22).

Patch from Frans Pop <elendil@planet.nl>.

Avoid "Debianised" or "Debianized" in Policy wording

* Avoid "Debianised" or "Debianized" in favor of just "Debian" or
  "Debian package" as appropriate.  Patch from Ben Finney.
  (Closes: #586163)

Fix various wording problems with the new Breaks/Conflicts sections

Fix a missing word in Breaks

Merge branch 'master' into bug578854-rra

Close the <qref> tag for f-Checksums

Significantly rework the discussion of Breaks and Conflicts

Recommend Breaks over Conflicts for most purposes.  List the places
Breaks should be used and the places Conflicts should be used.  Add
Breaks to the example in Replaces, and add a footnote explaining
why Breaks is normally required along with Replaces when files are
moving between packages.  Add additional discussion of conflicting
with a virtual package.

Merge branch 'master' into bug104373-rra

Merge branch 'master' into bug575639-rra

Conflicts:
debian/changelog

Add changelog and upgrading-checklist for #575639

Fix some minor (pre-existing) Maintainer and Uploaders syntax

Terminate an HTML entity and be clearer about the cross-reference
to the Maintainer field in the Uploaders field.

Add changelog and upgrading-checklist for #347581

Merge branch 'master' into bug347581-rra

Tighten requirements for maintainer-like fields

The syntax of Maintainer is a must, not a should.  The comma
separator in Uploaders is a must, not a should.  Now allow people
to use multi-line Uploaders fields freely.  Be explicit that the
Changed-By field has the same syntax as Maintainer and be clearer
about what identity goes here.

Changelog and upgrading-checklist for #555978

Merge branch 'master' into bug555978-rra

Merge branch 'master' into bug478295-rra

Add changelog and upgrading-checklist for #478295

Fix pluralization error in Checksums-* description

Fix typo (in BSD license footnote)

Document Checksums-Sha1 and Checksums-Sha256

Add documentation for the Checksums-Sha1 and Checksums-Sha256 fields
and mark them as recommended for both source and changes files.  Also
reorder the field listing in source and changes files to match the
order in which dpkg-dev writes the fields.

Relax requirement that library development files be in one package

Say instead that installing the library development package must
result in installation of all the required files, which allows for
further splits with appropriate Depends.

Explicitly allow cgi-bin programs in a subdirectory

The current wording could be read to imply that subdirectories of
/usr/lib/cgi-bin aren't allowed.  Explicitly permit installation of
CGI programs in a subdirectory of that directory.

Clarify the wording about which build dependencies must be satisfied

* Clarify the wording around which build dependencies must be satisfied
  for different debian/rules targets and add a footnote to the
  description of the build-arch and build-indep targets explaining why
  this split does not currently work as desired.  (Closes: #328951)

Explicitly say that obsolete config files may be removed

* Explicitly state that packages may remove unmodified, obsolete
  configuration files during  upgrade.  (Closes: #470633)

Add an example of Replaces for a package split

* Add an example for Replaces when a package is split.  Thanks, Uwe
  Kleine-König.  (Closes: #572253)

Changelog and upgrading-checklist information for Bug#284340

Wording improvement for forbidding duplicate fields

Prohibit duplicate field names in a control paragraph

Bug#555978.

Merge branch 'master' into bug284340-rra

Some additional tweaks to the license count script

Also look for LPPL version 1.3a and for any version of the license.
Be case-insensitive when looking for the Artistic 2.0 license.

Do not tell packagers to reference /usr/share/common-licenses/BSD

Remove the University of California BSD license from the list of
licenses that should be represented by references to
/usr/share/common-licenses and explain in the footnote why packages
should copy the license text instead.

Part of the resolution of Bug#284340.

Some additional fixes to the license classification script

Add counts for any version of the GFDL, GPL, or LGPL.  Clarify which
version of the LaTeX PPL this is checking.  Add a total package count
to the bottom.

Add a script to count license usage in Debian

Add tools/license-count, which takes the path to a Lintian lab and
counts license usage in Debian using regular expression matches
against the text of the debian/copyright file.

Fix typo in footnote about help2man

Minor editing, changelog, and upgrading-checklist for #569174

Specification of date format -- bug #569174.

RFC 822 dates use only two digits for the years, but Debian changelogs
described by this paragraph (§4.4 in Policy 3.8.4) use four digits.

This patch replaces the reference to the RFC 822 by a specification that is
compatible with its successors, RFC 2822 and RFC 5322, but does not use their
full range of options.

Reletter Process and update HTML style for *.org files

Reletter the process steps to not skip State C and use more
traditional foreground and background colors for Process.html and
README.html.  (Closes: #584521)

Perl: Recommend DESTDIR instead of PREFIX with Makefile.PL

Packages using Makefile.PL should use DESTDIR rather than PREFIX
to install into the package staging area.  PREFIX only worked due
to a Debian-local patch.

Move silly version ordering example to a footnote

Closes: #560839

Remove footnote listing all known architectures

Remove the footnote listing every architecture known to dpkg.  This
list can be trivially produced by dpkg-architecture -L (already
noted), is very long, and quickly becomes out-of-date.

Add changelog and upgrading-checklist for Bug#224509

Merge branch 'master' into bug224509-rra

Add changelog and upgrading-checklist entries for Bug#530687