Delegate udeb policy description to d-i internals manual

Closes: #698030

Changelog entry for the work in progress in #598645.

Delegate deb(5) format description to the man page

The information in this section is in any case not very complete,
and covered already in way more detail by the man page.

Switch appendix section for dpkg-buildpackage into a stub

The section only documents things already present in the man page,
and in cases the documentation is outdated. Just turn it into a stub
pointing to the man page, to avoid renumbering issues.

Replace appendix sections by stubs.

(Replaces Guillem's patch "Remove appendix sections for dpkg-genchanges,
dpkg-parsechangelog and dpkg-architecture")

Refer to the dpkg man pages for programs not described in the appendices

This will allow to progressively remove specific program sections, that
have been either integrated into the policy or the dpkg documentation.

Document Debconf's escape capability.

Closes: #671355.

Changelog for #700574.

Remove outdated mention of dselect documentation

There's no description in the appendices of the dselect access methods.

Changelog and upgrading-checklist for #697433.

Description of the Package-List field.

Closes: #697433

Changelog for #700536

Update dak reference from old katie name

Closes: #700536

Updated following the delegation of October 2012.

See: https://lists.debian.org/debian-devel-announce/2012/10/msg00006.html

Changelog and upgrading-checklist for #679326

Policy: Obsolete the DM-Upload-Allowed field.

Wording: Charles Plessy <plessy@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Seconded: Ansgar Burchardt <ansgar@debian.org>
Seconded: Guillem Jover <guillem@debian.org>
Closes: #679326
See: http://lists.debian.org/87vcf6lbw4.fsf@deep-thought.43-1.org

Changelog and upgrading-checklist for #690293

Checksums-Sha1 and Checksums-Sha256 are required by dak and therefore mandatory

Closes: #690293
See also: http://bugs.debian.org/478295#73

Fix typo in 8.6.4

Thanks, Raúl Benencia.  (Closes: #691352)

Finalize 3.9.4.0

Add changelog and upgrading-checklist for #661816

Minor wording tweaks to the update-mime change

Based on a message from Guillem Jover.

Rely on triggers instead of calling update-mime

Closes: 661816
This patch also:

 - Removes mention of the MIME policy.  This is a leftover from its removal.
 - Documents /usr/lib/mime/packages/, and recommends to use binary package
   names as a file names.
 - Cosmetically changes the emphasis on a "should not".

Add changelog and upgrading-checklist for #591791

Move alternative init systems to avoid renumbering

While keeping all the init-related material together would be nice,
it causes section renumbering, which causes other problems.  Move it
to the bottom of that chapter.  We'll fix this when we rewrite all of
Policy and reorder everything.

Document generic and upstart-specific init-system requirements

Add a new section on alternative init systems that outlines the
compatibility requirements for both init replacements and packages shipping
upstart jobs.  Closes: #591791

Add changelog and upgrading-checklist for #374029

Merge branch 'master' into bug345619-rra

Add changelog and upgrading-checklist for #571776

Merge branch 'master' into bug571776-rra

Fix incorrect closing tag

Add changelog for #676561

Document restrictions on use of /run for wheezy

Reflect the common case in the shlibs example

symbols/shlibs policy: cosmetic fixes

Use "zlib1g (>= 1:1.2.3.3.dfsg-2~)" in the sample shlibs dependency
field to emphasize the backport-friendly convention described in the
sharedlibs-updates section.

Also correct two small typos --- one sentence is uncapitalized and
another missing a noun --- and rephrase a sentence that describes when
to bump the dependency-version to make it easier to read.

Further wording changes on top of Jonathan Nieder's work

Add a footnote explaining what a "reasonable" program is.  Clarify
the shlibs versioning text.  Other minor textual changes for
clarity.

Clarifications to symbols and shlibs policy

subject/verb agreement: s/provide/provides/

Packages with libraries or binaries linking to a shared library must
use symbols or shlibs files to compute their dependencies.  Packages
that dlopen() a shared library should do so as well, but since that
is not typical practice and the tools to do that don't exist, it is
not made a policy "must" yet.

The minimal version for a symbol can be bumped after the version of
the package in which the symbol was introduced.

Add a footnote explaining why shlibs files cannot be used for
libraries with unusual sonames.

The shlibs file for a library udeb goes in the corresponding deb.

The library deb corresponding to a udeb is supposed to provide a
shlibs file, rather than consuming (using) one.

Add "for example" when talking about dpkg-shlibdeps -T.  This is
just an illustration and not meant to be normative.

If a library is used both directly and indirectly, the direct
dependency still needs to be declared.

Backward-compatibility is defined in terms of what reasonable
programs and libraries need.

In the normal case, symbols files go in dpkg's admindir as package
control files.

wording fix: "dependency on" avoids some of the ambiguity in
"dependency of".

Merge branch 'master' into bug571776-rra

Make build-arch and build-indep required targets

Implement the Debian Technical Committee decision in #629385.
Remove the normative documentation of what to do when the targets
aren't provided.  Remove the informative footnote saying that
the build daemons don't support this.

Closes: #374029 (among others)

Add changelog and upgrading-checklist for #670429

Add 'tasks' section

This also arranged the list as one name per line, in plain text,
alphabetically sorted, for better tracking.

Closes: #670429

Add changelog and upgrading-checklist for #654958

Document VCS fields

Uses Developers's Reference §6.2.5 for inspiration.

Closes: #654958
[jrnieder@gmail.com:
 - declared repositories should be publicly accessible
 - Vcs-Browser should point to a webapp
 - Vcs-<system> should use the version control system's conventional syntax
 - if multiple branches are used for packaging (e.g., "stable",
   "testing", "sid"), any one of them will do
 - for Vcs-Git, "-b <branch>" can be omitted when the intended branch is the
   default branch
 - list some Vcs-<foo> fields by name in the lists in §5.2 and §5.4
 - declared repositories track development of the Debian source
   package, not just the upstream code
 - Vcs-Browser can be a web interface using any protocol (e.g., HTTPS
   is fine)
 - picking a good branch is optional
 Thanks to Russ Allbery for several improvements to the text.]

Add changelog and upgrading-checklist for #641153

Document the Built-Using field

Thanks to Ansgar Burchardt <ansgar@debian.org>.
Closes: #641153
[jrnieder@gmail.com: with spelling fixes from Jakub Wilk]

Prohibit deprecated < and > relations

Wording: Jakub Wilk <jwilk@debian.org>
Seconded: Cyril Brulebois <kibi@debian.org>
Seconded: Russ Allbery <rra@debian.org>
Closes: #663918
Also minorly reword this section for clarity.

All copyright files must be encoded in UTF-8

Wording: Russ Allbery <rra@debian.org>
Seconded: Guillem Jover <guillem@debian.org>
Seconded: Salvatore Bonaccorso <carnil@debian.org>
Seconded: Simon McVittie <smcv@debian.org>
Closes: #661933

Further symbols wording fixes from Charles Plessy

Retain the dpkg-shlibdeps section in the appendix as a stub pointing
to the main page so that we don't renumber subsequent sections.  Add
more explanation for why dependencies change for each build of a
binary package.  Combine the dpkg-shlibdeps instructions somewhat and
mention that debian/substvars is only a default.

Substantial revision to the new symbols draft

Pull out lots of information that's shared between symbols and shlibs
into new sections directly under shared library dependencies.  Make
both symbols and shlibs subsections of that section.  Flesh out the
documentation of how to choose between symbols and shlibs and what the
differences in the systems are.

Document that C++ libraries may be better off with shlibs and don't
deprecate shlibs quite as much.

Move the information on how to determine the shared library soversion
to the runtime shared library section where it's now primarily used,
and reference it in the shlibs section.

Merge branch 'master' into bug571776-rra

Update release date of package

Collapse multiple copyright comments into one

Expand package long description to include all documents

Finalize changes for 3.9.3.1

Convert debian/copyright to copyright-format 1.0

* 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.

Add Policy version to DocBook subdocuments, fix whitespace

* 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 copyright-format license to not reference copyright notice

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

Further tweaking of the language around checking shell scripts

Thanks to Jonathan Nieder for the improvement.

Update dpkg-buildpackage documentation to mention fakeroot

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

Improve wording of DM-Upload-Allowed description

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

Clarify dependency relationships between build, build-{arch,indep}

* 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)

Field names may not contain spaces

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

Make wording about following the FHS less ambiguous

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

Suggest checkbashisms or posh rather than dash to check scripts

* 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 clarifications to copyright-format 1.0

* 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

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

Install copyright-format source without a version

* 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.

Don't close 639663 (upgrading checklist links)

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

Update .gitignore

Install HTML upgrading-checklist in policy.html directory

* 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.

General cleanup of debian/rules

* 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.

Remove unused debian-policy:Version substitution variable

Add missing entries to the virtual package names list changelog

Fix mistaken word choice in 3.9.3 upgrading-checklist

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

Finalize changes for 3.9.3.0

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

Reference copyright-format from Debian Policy

Add changelog for the changes for copyright-format publication

Publish copyright format specification version 1.0 (DEP 5)

Add changelog for copyright-format changes

Standardize on en_GB spelling

Copyright format reformatting

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

General editing pass for the copyright format specification

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.

DEP-5 updates from further debian-project discussion

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.

Update copyright-format to match the current DEP-5 website text

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.

Update tools/license-count to work with the new Lintian lab layout

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

Virtual: Retire java-compiler, java2-compiler, and java-virtual-machine.

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

Correct syntax error by closing SGML tag.

Fix formatting of the symbols file

Alternative dependencies and metadata fields should not be indented
by a space.

Merge branch 'master' into bug571776-rra

Improvements and simplifications of symbols/shlibs rewrite

Based on review by Raphaël Hertzog.

Add changelog and upgrading-checklist for #498300

Merge branch 'master' into bug498300-rra

Changelog and upgrading-checklist for #620870

Merge branch 'master' into bug620870-rra

Fix typo in version numbers in dpkg-divert example

* Fix typo in the version numbers in the dpkg-divert examples.  Thanks,
  Slavko.

Fix typo (thanks, Niels Thykier)

Dependency architecture restrictions must be non-empty

An empty list of architectures doesn't make sense and has an
ambiguous meaning, so just make it a syntax error.

Closes: #498300

List all dependency fields packages in main may not use with non-main

* Clarify that packages in main may not declare Pre-Depends or
  Build-Depends-Indep relationships outside of main either.  Partly
  addresses #587279.

First draft of symbols documentation

Based heavily on the existing shlibs section and on the
deb-symbols(5) manual page.  The symbols section takes over as
the default recommendation and shlibs moves one section later.
Also includes more information about when to change the minimal
version in the symbols file.

Remove the "should" to use /run instead of /var/run

This requires a dependency on a newer initscripts and has cross-
distribution compatibility problems, so is probably premature at
this point.