[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>

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>

[bug545548-srivasta]: Add Documentation

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.

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.

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

Added changelog for #542865.

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

Merge branch 'bug542865-srivasta'

Provide changelog for the typo fix -- manoj.

Bug#542865: Grant an FHS exception for the multiarch library directories

On Fri, Aug 21, 2009 at 09:25:30PM -0700, Russ Allbery wrote:
> Manoj Srivastava <srivasta@debian.org> writes:
> > On Fri, Aug 21 2009, Russ Allbery wrote:

> >> The current restriction is specific to libraries.  Don't we need to say
> >> that you can't put *any* files into any triplet directory that isn't
> >> for your package architecture?

> >         Hmm. My first read was that one could not put anything that was
> >  not a library in these directories, but perhaps it should be stated
> >  explicitly.

> I was expecting that we'd need to put anything that you might want to have
> simultaneous installs from multiple architectures in that directory, which
> would include, for instance, any shared library plugins or loadable
> modules, which aren't strictly libraries.

> We might have to duplicate some library helper programs as well, if for
> instance they communicate with the library using binary structures that
> are sensitive to sizeof(long).

Right, this was a bug in the proposed patch, not a deliberate statement that
only libraries belong in these directories.  (As I mentioned, the first
patch was something of a trial balloon.)  I think this updated patch should
cover everything for the first round.

Re-seconds?

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

Typo fix: relayed -> related.

Thanks to Matt Kraai for pointing this out.

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

Merge branch 'master' into srivasta

* Also provide documents in single-file HTML format.
  Proposed by Jari Aalto.
Closes: #544353

Update standards version to 3.8.3

Finalize changes for 3.8.3.0

Document install-info dependency in upgrading-checklist

Document that control field values are case-sensitive

Document that control field values are case-sensitive unless the field
description says otherwise.

Remove seconds by non-DDs

Consensus on debian-policy seems to be that seconding should be
restricted to Debian Developers, so remove seconds from non-DDs and
add an additional second from that thread for the man page translation
change.

sensible-* come from the sensible-utils package

Say that sensible-editor and sensible-pager are provided by the
sensible-utils package, not by the base system.  Thanks, Clint Adams
and Steve Langasek.  (Closes: #541537)

Add dependency recommendation for packages with info documents

This is an additional fix for #538665.  Recommend a dependency that
ensures a triggerized install-info is available so that the dir file
will be properly rebuilt on partial upgrades from lenny.  Reviewed
by Bill Allombert and Raphaël Hertzog.

Merge branch 'bug538665-rra'

Changelog and upgrading-checklist for #538665

Fix the footnote on modifying Texinfo source for dir information

The footnote about how to modify the Texinfo source to add the necessary
info directory information ended two lines before it should.  Thanks,
Raphaël Hertzog.

dpkg triggers, not dpkg hooks, for install-info

Fix typo in Description control field description

Thanks, Ben Finney.

Improve Description and Changes specification for *.changes

* Change the wording of the Description and Changes field specifications
  for *.changes files to more closely match the wording for Files and
  add more details about the contents of the Description field in
  a *.changes file.

Clarify the description of the Files control field

Reword a difficult sentence in the Files control field description and
add examples of the two versions of the field.  Thanks to Jeremiah
Foster for the report and wording discussion.

Add an SGML comment with a close double-quote to unconfuse Emacs

Emacs wants the unmatched double-quote in the discussion of init scripts
to be closed and otherwise treats the rest of the file as if it's in a
string.  Unconfuse it with an SGML comment.

Changelog and upgrading-checklist for #533852

Merge branch 'master' into bug533852-rra

Add a changelog entry for merging package name syntax requirements

Remove the encoding requirement for manual pages

Previously, all characters in a manual page had to be representable in
the legacy encoding for that language due to limitations in groff.  The
current release of groff removes that limitation, so this restriction
can be lifted.

Patch from Colin Watson.  Debian Bug#537707.

Merge branch 'master' into bug533852-rra

Fix another typo in the Installed-Size field description

Don't suggest calling dpkg-statoverride --remove unconditionally

The system administrator may have removed an override, and --remove will
fail if none exist.  Suggest checking first to see whether the override
exists before removing it.

Thanks, Patrick Schoenfeld and Guillem Jover.

Merge branch 'master' into bug538665-rra

Merge branch 'master' into bug533852-rra

Change estimation to estimate in the Installed-Size field description

Thanks, Emilio Pozuelo Monfort.

Rewrite info documents section

install-info now uses dpkg hooks, so remove all requirements for running
install-info in package maintainer scripts.  Document the necessary info
directory information and provide Texinfo modification instructions in a
footnote.  Explicitly forbid packages from including /usr/share/info/dir.

Unify the syntax description for package names

In the Package field description, reference the syntax for source package
names in the Source field description rather than repeating it.  Add a
cross-reference to Package in the Source field description.

Reported by Jonathan Yu.

Add section ID for appdefaults for cross-references

Changelog and upgrading-checklist for #493007

Merge branch 'master' into bug533852-rra

Merge branch 'master' into bug493007-rra

Changelog and upgrading-checklist for #522217

Merge branch 'master' into bug533852-rra

Merge branch 'master' into bug493007-rra

Merge branch 'master' into bug522217-rra

Add changelog and upgrading-checklist for #519941

Merge branch 'master' into bug519941-rra

Allow the Binary control field to wrap

Allow the Binary control field to wrap in both *.dsc and *.changes files,
since we have some source packages that produce lines so long that GnuPG
is no longer willing to sign the file.

Clearly state that the syntax is different depending on whether the field
appears in a *.dsc file or a *.changes file.

Thanks to Raphaël Hertzog for the report.  Debian Bug#533852.

Improve the Installed-Size wording

Avoid the term kibibytes, which is controversial.  Document that
Installed-Size is only an estimate and may vary based on block size,
file system properties, and actions taken by maintainer scripts.

Using /etc/X11 for configuration is allowed, not should

Expand the list of applications that may use /etc/X11 for configuration
files to include session managers, but change this section to may from
should.  There doesn't appear to be a reason to encourage this going
forward.  Reword the section for more direct phrasing.

Merge branch 'master' into bug522217-rra

Explain the copyright dates

* Explain that the copyright dates are for the original Policy manual
  and that there is no updated list of copyright holders for subsequent
  revisions available.  (Partly addresses #47438)

Further clarification for Installed-Size

Specify that the value is rounded up since that's what du does, and
move the parentheses to be clearer.

Clarify that Installed-Size is in kibibytes

* Clarify that Installed-Size is in kibibytes.  Thanks, Martin Dorey.
  (Closes: #534408)

Add changelog and upgrading checklist for #514919

Merge branch 'master' into bug514919-rra

Remove obsolete versioned Perl depend and build-depend requirement

Perl modules are no longer required to build-depend on perl 5.6.0-16
or later and arch-independent modules are no longer required to depend
on perl or perl-base 5.6.0-16 or later.  All versions of Debian
released for years have shipped with a newer version of Perl than that.

Wording from Cyril Brulebois.  Bug#525190.

Rewrite X installation directory issues

Rework the whole section on X installation directory issues to remove
obsolete transitional requirements and to be clearer about the history
of alternative installation directories and the mapping of old to new
locations.

Based on wording from Julien Cristau.  Bug#522217.

Recommend localized man pages be up-to-date or warn they're not

Based on a wording proposal by Helge Kreutzmann with additional
input from Christian Perrier, but with extensive rewording.

Reduce the footnoted list of distributions to two examples

Merge branch 'master' into bug514919-rra

Remove Policy permission for packages to modify ld.so.conf

Remove the Policy permission for packages to install libraries in a
subdirectory and add that directory to /etc/ld.so.conf.

Add changelog and upgrading checklist for #530967

Merge branch 'master' into bug530967-rra

Add changelog and upgrading-checklist for #527871

Update information about DEB_*_ARCH variables

Recommend using the DEB_*_ARCH_CPU and DEB_*_ARCH_OS variables instead
of the GNU style ones. And mention that the latter are mostly intended
for use with upstream build systems, and not Debian packaging.

Add cross-references to Breaks and Conflicts in dependency section

* Add references to the sections on Breaks and Conflicts to the section
  on binary dependencies.  Thanks, Frank Küster.  (Closes: #529771)

Merge branch 'master' into bug530967-rra

Merge branch 'master' into bug514919-rra

Order by section in upgrading-checklist

Drop another warning about using Breaks before stable dpkg supports it

* Breaks is now supported by the stable release of dpkg, so drop
  warnings against its use.  Thanks, Steve Langasek.  (Closes: #533577)

Breaks are supported in stable, so are now allowed in the archive

Bring Architecture description in line with dpkg-source

dpkg-source now may include "all" in the list of architectures in the
*.dsc Architecture field.  Rewrite the Architecture section to be
clearer about the acceptable values in different contexts and what
they mean.

debian/rules: Fix a race condition while generating DEBIAN/md5sums.

Release policy 3.8.2.0

Add myself to Uploaders.
Update Standards-Version to 3.8.1 (no changes required).
debian/rules: use dpkg --print-architecture instead of
obsolete form dpkg --print-installation-architecture

debian/changelog: Closes: #533257

Colin build fix already addresses #533257

Merge branch 'master' into srivasta

Add myself to Uploaders.

tidy up changelog ordering

State requirements for source package names. Closes: #525151

Build-depend on texlive-latex-extra, which is needed by debiandoc2latexps and isn't included in texlive's dependencies.

Spelling fixes

The FHS is the "Filesystem Hierarchy Standard", regardless of our
preferred spelling of "file system" elsewhere. Fix this and a nearby
search-and-replace capitalisation bug.

Move Speedo fonts into the deprecated category

The Speedo directory isn't part of the default X font path for a long
time, and libxfont in lenny disabled support for speedo fonts.

Closes #522218

Remove obsolete /var/mail transition requirement

Add changelog and upgrading-checklist for #522219