* Convert debian/copyright to copyright-format 1.0, and in the process
  add the license information for the documents other than Policy itself
  and the FHS.  Note the implication of the GPL source code requirement
  for distributing generated versions of the Policy documents.

* Embed the Debian Policy version and build date in the debconf
  specification and the copyright-format document.  We'll make
  non-normative changes without updating other version numbers, and it's
  good to know which version one is looking at.
* Fix some whitespace issues in the debconf specification articleinfo.

* Fix the legal notice in copyright-format to not refer to a nonexistent
  copyright notice.

Thanks to Jonathan Nieder for the improvement.

* Update the dpkg-buildpackage -r documentation in the appendix to
  reflect the current behavior of using fakeroot.  Wording from Sam
  Morris.  (Closes: #658009)

* Clearly state that "yes" is the only valid value of DM-Upload-Allowed
  and rewrite its description to be less indirect.  (Closes: #622263)

* Clarify that only one of build-arch or build-indep may be provided
  (currently, at least) and that build should depend on whichever exist
  or perform the equivalent actions.  Thanks to Jonathan Nieder for some
  of the wording.  (Closes: #601839)

* Clarify the syntax of field names to make it clear that they may not
  contain spaces.  Thanks, Charles Plessy.  (Closes: #647645)

* Remove the ambiguous word "installed" when requiring that the location
  of files and directories follow the FHS.  (Closes: #638060)

* Suggest checkbashisms from devscripts or the posh shell for checking
  whether /bin/sh scripts are Policy-compliant rather than recommending
  dash.  Thanks, Raphael Geissert.  (Closes: #490604)

* Additional wording improvements to copyright-format 1.0 for clarity.
  Also mention that the Files pattern syntax is the same as fnmatch(3)
  and GNU find -path without [] patterns.  Thanks, Jonathan Nieder and
  Ben Finney.

* Fix cross-reference to control field syntax in Policy 5.4 (source
  package control files).  Thanks, Jakub Wilk.  (Closes: #661412)

* Ship the copyright-format source as copyright-format.xml.tar.gz
  without a version, since it will include all of the versions, not just
  the current version.

This bug also involves linking the relevant sections from the
checklist to Policy, which isn't handled yet.

* Install the HTML version of upgrading-checklist in the policy.html
  directory as upgrading-checklist.html so that it can be deployed on
  www.debian.org in a way that will allow links to Policy sections to
  work easily.  Thanks, Charles Plessy.  (Closes: #639663)

For right now, this is done with a bit of a hack to copy the file into
the appropriate directory and to turn the one-page HTML version of it
into a symlink inside the constructed package.

The clean solution will be to make the upgrading checklist an appendix
of Policy, which may be done as part of a DocBook conversion.

* Strip down and reformat debian/rules to remove unused variables,
  references to old files no longer included, use a more standard
  layout and standardize variable names, and add comments for better
  maintainability.

* Fix mistaken word choice (prefix instead of suffix) in the upgrading
  checklist entry for 3.9.3.0.

Some wording tweaks for the upgrading-checklist as well, and the
changelog entry for virtual-package-names-list.

Reformat parts of the copyright format standard to avoid lines longer
than 79 characters and to fix some incorrect indentation.

Add a pointer to DEP-5 in the synopsis and change the verb tense
to present from imperative.  Rephrase the introduction to talk about
this document as a specification rather than a proposal.

Explicitly mention Files: * as the way to write a single files
paragraph that covers the entire package.

Mention after one of the examples that the two paragraphs for files
with the same license but different copyright holders could be combined
at the discretion of the document author.

Give the complete correct Format field for the current version of the
document in the description of that field.

Add more explanation for how Disclaimer is used.

Say explicitly that more general files paragraphs should be given
first, followed by more specific overrides.

Update the license list to note that "Universal" is removed from the
version of CC0 when forming the short name, to list the new versions
of the GFDL, and to be more explicit about when to use GFDL-NIV.

Rewording and rephrasing in various places to hopefully make the
text flow better, read more smoothly, and be more idiomatic.

Add multiple additional in-line examples, particularly around the
Files patterns and the formation of license short names.

Charles Plessy authored Feb 21, 2012 and Russ Allbery committed Feb 21, 2012

Clarify that this document does not supersede or modify the
requirements in Policy and that use of the specification is
optional.  Note that a single Files paragraph can apply to the
whole package (rather than using the "all files" wording) and
that only the license and copyright information required by
the Debian archive has to be listed.

Clarify the wording of stand-alone license paragraphs to be
clear that they can be used with exceptions.

Some wording improvements, including making the attributes
listed after the fields lowercase.  Fix a few links and the
official keyword of the BSD-3-clause license in some examples.

Add a Version 1.0 subtitle.

This addresses multiple issues, clarifications, and reformatting
done as part of the DEP process after the initial import of the
document into the Debian Policy repository.

This is still a quite-ugly hack, but at least it works.

Proposed by: Niels Thykier <niels@thykier.net>
Seconded: tony mancill <tmancill@debian.org>
Seconded: Bill Allombert <ballombe@debian.org>
Closes: #578421