Charles Plessy [Tue, 1 Jun 2010 01:27:39 +0000 (10:27 +0900)]
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.
Russ Allbery [Fri, 4 Jun 2010 16:43:00 +0000 (09:43 -0700)]
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)
Russ Allbery [Fri, 4 Jun 2010 16:24:20 +0000 (09:24 -0700)]
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.
Russ Allbery [Fri, 4 Jun 2010 05:44:14 +0000 (22:44 -0700)]
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.
Russ Allbery [Fri, 4 Jun 2010 05:20:44 +0000 (22:20 -0700)]
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).
Russ Allbery [Thu, 3 Jun 2010 17:04:11 +0000 (10:04 -0700)]
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.
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.
Russ Allbery [Wed, 2 Jun 2010 17:02:43 +0000 (10:02 -0700)]
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)
Russ Allbery [Wed, 2 Jun 2010 16:37:39 +0000 (09:37 -0700)]
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)
Russ Allbery [Tue, 1 Jun 2010 22:47:48 +0000 (15:47 -0700)]
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.
Russ Allbery [Tue, 1 Jun 2010 17:40:41 +0000 (10:40 -0700)]
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.
Russ Allbery [Mon, 31 May 2010 17:11:43 +0000 (10:11 -0700)]
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.
Russ Allbery [Mon, 31 May 2010 17:04:17 +0000 (10:04 -0700)]
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.
Bill Allombert [Mon, 25 Jan 2010 20:43:39 +0000 (21:43 +0100)]
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]*.
Manoj Srivastava [Sat, 21 Nov 2009 07:33:13 +0000 (01:33 -0600)]
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>
Manoj Srivastava [Sat, 21 Nov 2009 06:32:10 +0000 (00:32 -0600)]
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.
Manoj Srivastava [Sat, 21 Nov 2009 06:03:12 +0000 (00:03 -0600)]
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>
Manoj Srivastava [Fri, 20 Nov 2009 18:26:21 +0000 (12:26 -0600)]
[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.
Russ Allbery [Thu, 12 Nov 2009 21:26:50 +0000 (13:26 -0800)]
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.
Manoj Srivastava [Tue, 13 Oct 2009 17:05:18 +0000 (12:05 -0500)]
[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)
[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.
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>
[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.
[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.
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.
Steve Langasek [Sat, 5 Sep 2009 03:50:30 +0000 (20:50 -0700)]
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.
Russ Allbery [Sun, 16 Aug 2009 00:04:24 +0000 (17:04 -0700)]
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.
Russ Allbery [Sun, 16 Aug 2009 00:04:00 +0000 (17:04 -0700)]
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)
Russ Allbery [Sat, 15 Aug 2009 23:49:37 +0000 (16:49 -0700)]
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.
Russ Allbery [Mon, 10 Aug 2009 20:23:34 +0000 (13:23 -0700)]
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.
projects / debian / debian-policy.git / log