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.

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

Move Architecture Wildcards to a subsection

Make Architecture Wildcards a subsection of Architecture specification
strings so that we don't renumber all the subsequent sections (and
because it seems to make slightly more sense).

The architecture value "any" may not be combined with others

Adjust the wording for architecture wildcards to reflect that dpkg
requires "any" be alone if it is used.

Merge branch 'master' into bug530687-rra

Fix SGML error in upgrading-checklist entry for init.d scripts

Perl Policy: Change perlapi provides to use an ABI version

Perl now provides perlapi-<abiversion> where <abiversion> may be
more than just the version of Perl.  Packages must update their
dependencies accordingly, using $Config{debian_abi} to form the
package dependency if set and falling back on $Config{version}
otherwise.

Rephrase architecture wildcard description somewhat

Reorganize and rephrase the description of architecture wildcards
to combine related paragraphs and to ensure consistency of wording
between the source control section and the *.dsc section.

Remove some extraneous information about architecture wildcards

Remove some details in footnotes that are internal implementation
details or just confusing and reword somewhat based on feedback from
Guillem Jover.

Merge branch 'master' into bug530687-rra

Allow abort if a required prompt can't be answered

Allow, but caution against, maintainer scripts to abort if a required
prompt has no reasonable default and there is no controlling terminal.

Merge branch 'master' into bug224509-rra

Add changelog and upgrading checklist for Bug#562506

Merge branch 'master' into bug562506-rra

Fix additional typo in architecture wildcards

Found by Cyril Brulebois.

Merge branch 'master' into bug530687-rra

Ignore upgrading-checklist.html

Document debian-installer section and link to section list

Document the special debian-installer section in the list of current
sections and add a link to the list of sections in unstable, which
contains longer descriptions.  (Closes: #577666)

Clarify Perl Policy about essentialness of perl-base

Clarify in the Perl Policy that perl-base is essential, not perl, and
don't imply packages need to depend on perl-base.  (Closes: #576594)

Remove obsolete footnote comment about dpkg-statoverride

Remove obsolete footnote sentence saying that dpkg-statoverride is a
new feature and not well-known.  (Closes: #563425)

Remove documentation of alternative changelog formats

Remove documentation of alternative changelog formats.  This feature
is not allowed in the Debian archive and will be documented in the
dpkg-dev documentation instead.  The documentation that was in Policy
was also somewhat outdated.  (Closes: #555009, see #584141)

Merge branch 'master' into bug562506-rra

Merge branch 'master' into bug224509-rra

Merge branch 'master' into bug530687-rra

Further fixes to the architecture wildcard patch

Based on feedback from Kurt Roeckx.  Be explicit about what happens with
*.dsc and *.changes files, reorder the discussion somewhat, and remove
some duplicate text.

Merge branch 'master' into bug530687-rra

Extend UID range of user accounts

Extend UID range of user accounts by removing the 30000-59999 reserved
ranges.  Proposed by Santiago Vila. Closes: #582495

Except init.d scripts from the normal set -e requirement

Mention init.d scripts as a special exception from the normal advise
to always use set -e in all shell scripts, and add a new paragraph to
the section on init.d scripts advising caution in using set -e and
explaining some of the issues.

Further architecture wildcard wording clarifications

Call out "all" specifically in more places and fix some grammatical
and wording issues from multiple editings.

Replace 'copyright' by 'copyright information'.

Proposed by Jonathan Nieder.  Closes: #566220

Replace 'copyright' by 'copyright information'.

Proposed by Jonathan Nieder.  Closes: #566220

Whitespace fixes in architecture wildcard paragraph

Treat any as just another architecture wildcard

Now that we describe architecture wildcards, any is just another
wildcard.  This mostly reverts to the state of Manoj's previous
wording proposal but also updates the list of possible values at
the start of the Architecture section.

Additional wording improvements for arch wildcards

Keep the previous wording discussing use of any and all in the
Architecture control field.  Try to further clarify how wildcard
matching is done to decide whether a binary package is built on the
current architecture.  Explain how the first component of the
Debian architecture triplet is derived.

Merge branch 'master' into bug530687-rra

Add changelog entry for #442134

Correct punctuation pointed out by Guillem Jover

Uniformly use double quotes around references to "Half-Installed" or
"Half-Configured".

Merge branch 'master' into bug442134-srivasta

Fix typo in package_upstream-version.orig.tar.gz.

Closes: #558430

Convert upgrading-checklist to debiandoc-sgml

(Closes: #567845)

Merge branch 'master' into bug567845-ballombe

Fix path to changelog.Debian.gz in footnote on documentation symlinks.

Convert upgrading-checklist.org to debiandoc-sgml.

Bump Standard-Version to 3.8.4

Finalize changelog for release.

Brace filenames with ~...~

This avoids /.../ to be intepreted as italic.

Clean up references in upgrading-checklist.

The old upgrading-checklist assumed references were after the message instead
of before. Adjust to reflect that.
Fix /etc/init.d/*SK]* to /etc/init.d/[SK]*.

Replace &lt; by < and &gt; by >

Fix typo Clarigy -> Clarify.

Set release date of the upgrading checklist for 3.8.4

Added changelog for the cron-daemon package addition

Signed-off-by: Russ Allbery <rra@debian.org>
Signed-off-by: Kurt Roeckx <kurt@roeckx.be>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

[bug442134-srivasta]: Flip back and revert to using Half-Configured state

Since this is what dpkg has been revamped to do.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

New virtual package: cron-daemon

Create a virtual cron daemon package that:
 - Has to provide /usr/bin/crontab and support crontab entries
 - Correct execution of /etc/cron.d
 - Correct support of /etc/crontab
 - Support of crontab entries with names for days and months,
   ranges, step values
 - Correct execution of /etc/cron.{hourly,daily,weekly,monthly}

Signed-off-by: Javier Fernández-Sanguino Peña <jfs@computer.org>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Use the "Failed-Config" state instead of the synonymous halfconfigured

These terms are synonyms. dpkg and dselect use halfconfigured
internally and Failed-config when talking to the user. This patch
ensures that policy uses the same term as dpkg does when talking to
the user ("Failed-Config") for consistency.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Added changelog for the rules shebang line clarification

Signed-off-by: Ben Finney <ben+debian@benfinney.id.au>
Signed-off-by: Kurt Roeckx <kurt@roeckx.be>
Signed-off-by: Russ Allbery <rra@debian.org>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Clarify rule for debian/rules shebang line

Explicitly state that  "make -f debian/rules" and "./debian/rules"
must behave  identically, to prevent confusion, and to promote
reproducibility, and conform to the principle of least surprise.

Signed-off-by: Ben Finney <ben+debian@benfinney.id.au>
Signed-off-by: Kurt Roeckx <kurt@roeckx.be>
Signed-off-by: Russ Allbery <rra@debian.org>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Changelog and upgrading-checklist for FHS toplevel dir exceptions

Signed-off-by: Kurt Roeckx <kurt@roeckx.be>
Signed-off-by: Russ Allbery <rra@debian.org>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

[bug556972-srivasta]: Explicitly allow /selinux and /sys as FHS exceptions

 1) There are a lot of instances of programs looking things up in
    selinuxfs (indirectly through libselinux). Most of these instances
    look through /proc/mounts to discover where selinuxfs is mounted,
    and thus do not care about the actual location
 2) sysvinit (and upstart, if the patch is accepted) load the security
    policy for machines where SELinux is enabled, and need to mount
    selinuxfs to get details of the state of selinux in the
    kernel. Since /proc is not around when this happens, this is the one
    place where the distribution default od the selinuxfs mount point is
    hard coded.
 3) The default for fedora, gentoo, and Debian has been /selinux
 4) Lots of people have also setup /etc/fstab to mount selinuxfs on
    /selinux
 5) there are user scripts that assume they can look into /selinux on
    SELinux enabled machines, and this is a lot of things to change

This patch explicitly allows /sys and /selinux as additional
directories int he root file system allowed under the policy.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Explicitly load org-ascii when generating text files

Works around a problem with org-export-as-ascii not being apparently
autoloaded on at least some systems.

Ignore new generated files

Ignore the single-file HTML versions and policy.txt (uncompressed).

Changelog and upgrading-checklist for named pipe requirement

Clarify policy on named pipes in packages

Make explicit the requirement that packages not include named pipes in
addition to device files.  State that named pipes must be created in
postinst and removed in prerm or postrm as appropriate.  Suggest in a
footnote using mkfifo rather than mknod to avoid false positives from
package checkers.

Standardize on lowercase must for consistency

* Change the sole occurrence of MUST to must for consistency and to
  avoid confusion with IETF RFC keywords.  Thanks, Jakub Wilk.
  (Closes: #552757)

[typo-fixes]: Fix a number of grammatical or typographical errors

Thanks to  Eric Dantan Rzewnicki for pointing them out.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

[master]: Added changelog for bug 545548

This patch add a README file, rendered as txt and html, and also
documents the policy change process, again rendered as text and
HTML. While the text and HTML files are automatically generated, they are
shipped in the package itself so as to avoud depending on a recent
version of Emacs during build.  If a new Emacs is present, the .txt and
.html files shall be regenerated if the org file is newer.

The contents of the new documents are based on (but no identical to) the
contents of related pages on the Debian wiki. The long term plan is to
make these documents the canonical ones, and have the Wiki point to these
pages. Also render out a upgrading-checklist.txt (we can also do a
docbook version later)

Closes: #545548
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Merge branch 'bug545548-srivasta'

[bug545548-srivasta]: Added CUSTOM_ID and anchors to release headings.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Number the DFSG points like in the social_contract document.

[bug545548-srivasta]: Use a less confusing merge work-flow in the README

While still minimizing unneeded merges between master and bug branches,
this version of the document uses a less confusing command sequence. Also
update the HTML page.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

bug530687-srivasta: Support for architecture wildcards

Support for architecture wildcards has been added to dpkg-1.13.13. This
patch, based on a proposal from Andres Mejia, provides policy on how
architecture wildcards should be used for other tools such as sbuild and
pbuilder. This patch has tracked and incorporated suggestions embedded
the discussion of the proposal. It also brings policy up to speed and in
line with dpkg-dev which appears to generate an Architecture line that
includes both architectures and special values like "all".

See: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=530687
     http://lists.debian.org/debian-policy/2009/05/msg00108.html
for details.

Signed-off-by: Andres Mejia <mcitadel@gmail.com>
Signed-off-by: Manoj Srivastava <srivasta@debian.org>

Added changelog for #518199 .

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

[virtual packages]: Added virtual packages related to the Doom game engine

Added packages that support the Doom engine, a Doom engine which
supports the boom feature set, and virtual packages for the corresponding
data components.

Closes: Bug#518199
Signed-off-by: Manoj Srivastava <srivasta@debian.org>
Signed-off-by: Russ Allbery <rra@debian.org>
Signed-off-by: "Giacomo A. Catenazzi" <cate@debian.org>

[bug545548-srivasta]: Arrange to regenerate derived files from org source

For machines without a newer Emacs, this has no effect, but if a new
Emacs is present, the .txt and .html files shall be regenerated if the
org file is newer.

Signed-off-by: Manoj Srivastava <srivasta@debian.org>

[bug545548-srivasta]: Make upgradng-checklist a real HTML file

Also render out a upgrading-checklist.txt (we can also do a docbook
version later)

Signed-off-by: Manoj Srivastava <srivasta@debian.org>