]> git.donarmstrong.com Git - debian/debian-policy.git/commitdiff
Merge branch 'master' into bug473439-rra
authorRuss Allbery <rra@debian.org>
Mon, 2 Feb 2009 02:14:37 +0000 (18:14 -0800)
committerRuss Allbery <rra@debian.org>
Mon, 2 Feb 2009 02:14:37 +0000 (18:14 -0800)
.gitignore [new file with mode: 0644]
debian/changelog
policy.sgml
upgrading-checklist.html

diff --git a/.gitignore b/.gitignore
new file mode 100644 (file)
index 0000000..ab942fa
--- /dev/null
@@ -0,0 +1,18 @@
+/body.tmp
+/debconf_spec/debconf_specification.html
+/debconf_spec/debconf_specification.txt.gz
+/head.tmp
+/menu-policy.html/
+/mime-policy.html/
+/perl-policy.html/
+/policy.html/
+/stamp-build
+/version.ent
+*.html.tar.gz
+*.pdf
+*.pdf.gz
+*.ps
+*.ps.gz
+*.tpt
+*.txt
+*.txt.gz
index aa4062680375bcfbf82d0db1a60a5fd63c2de3bd..903d023b6c1fb8cca5552d65b39aa421f8fb49fd 100644 (file)
@@ -35,10 +35,19 @@ debian-policy (3.8.1.0) UNRELEASED; urgency=low
     Seconded: Jörg Sommer <joerg@alea.gnuu.de>
     Seconded: Guillem Jover <guillem@debian.org>
     Closes: #479080
+  * Policy: Allow user mail spools to be mode 0600 or 0660
+    Wording: Russ Allbery <rra@debian.org>
+    Seconded: Kurt Roeckx <kurt@roeckx.be>
+    Seconded: Andrew McMillan <awm@debian.org>
+    Closes: #470994
   * Improve the documentation of maintainer script actions for diversions
     in the informative appendix to allow for addition of a new diversion
     on upgrade and handle error cases correctly.  Thanks to Olivier Berger
     for the report and Raphaël Hertzog for the review.  (Closes: #483418)
+  * Clarify the meaning of architecture restrictions on build dependencies
+    in the presence of alternatives.  Thanks to Guillem Jover for the
+    explanation and review and Emilio Pozuelo Monfort and Don Armstrong
+    for wording review.  (Closes: #163666)
   * Use <user>:<group> notation rather than <user>.<group> notation in
     multiple places.  Thanks, Kurt Roeckx.  (Closes: #488039)
   * Fix typo in 3.8.0.0 upgrading-checklist entry.  Patch from Kobayashi
@@ -48,6 +57,11 @@ debian-policy (3.8.1.0) UNRELEASED; urgency=low
   * Clarify that translation is only required for user-visible debconf
     messages.  Capitalize "Debian Configuration Management Specification"
     uniformly.  Thanks, Julian Andres Klode.  (Closes: #492624)
+  * Add --wildcards to the sample tar command in appendix B.1 for
+    extracting the package copyright file, adjusting for new tar option
+    behavior.  Thanks, Yan Morin.  (Closes: #503685)
+  * Reword the requirement that maintainer scripts exit with a zero
+    status on success to avoid double-negatives.
 
  -- Russ Allbery <rra@debian.org>  Mon, 23 Jun 2008 19:23:50 -0700
 
index 0726795861e7c2459d38241d7758520c80175836..9b9ee4c22e4ebf6b9dd7421df0e830b53cb7a9e5 100644 (file)
@@ -3442,8 +3442,7 @@ Package: libc6
          scripts this means that you <em>almost always</em> need to
          use <tt>set -e</tt> (this is usually true when writing shell
          scripts, in fact).  It is also important, of course, that
-         they don't exit with a non-zero status if everything went
-         well.
+         they exit with a zero status if everything went well.
        </p>
 
         <p>
@@ -4195,6 +4194,22 @@ Build-Depends-Indep: texinfo
 Build-Depends: kernel-headers-2.2.10 [!hurd-i386],
   hurd-dev [hurd-i386], gnumach-dev [hurd-i386]
          </example>
+         requires <tt>kernel-headers-2.2.10</tt> on all architectures
+         other than hurd-i386 and requires <tt>hurd-dev</tt> and
+         <tt>gnumach-dev</tt> only on hurd-i386.
+       </p>
+
+       <p>
+         If the architecture-restricted dependency is part of a set of
+         alternatives using <tt>|</tt>, that alternative is ignored
+         completely on architectures that do not match the restriction.
+         For example:
+         <example compact="compact">
+Build-Depends: foo [!i386] | bar [!amd64]
+         </example>
+         is equivalent to <tt>bar</tt> on the i386 architecture, to
+         <tt>foo</tt> on the amd64 architecture, and to <tt>foo |
+         bar</tt> on all other architectures.
        </p>
 
        <p>
@@ -8079,12 +8094,27 @@ http://localhost/doc/<var>package</var>/<var>filename</var>
        </p>
 
        <p>
-         Mailboxes are generally mode 660
-         <tt><var>user</var>:mail</tt> unless the system
-         administrator has chosen otherwise.  A MUA may remove a
-         mailbox (unless it has nonstandard permissions) in which
-         case the MTA or another MUA must recreate it if needed.
-         Mailboxes must be writable by group mail.
+         Mailboxes are generally either mode 600 and owned by
+         <var>user</var> or mode 660 and owned by
+         <tt><var>user</var>:mail</tt><footnote>
+           There are two traditional permission schemes for mail spools:
+           mode 600 with all mail delivery done by processes running as
+           the destination user, or mode 660 and owned by group mail with
+           mail delivery done by a process running as a system user in
+           group mail.  Historically, Debian required mode 660 mail
+           spools to enable the latter model, but that model has become
+           increasingly uncommon and the principle of least privilege
+           indicates that mail systems that use the first model should
+           use permissions of 600.  If delivery to programs is permitted,
+           it's easier to keep the mail system secure if the delivery
+           agent runs as the destination user.  Debian Policy therefore
+           permits either scheme.
+         </footnote>. The local system administrator may choose a
+         different permission scheme; packages should not make
+         assumptions about the permission and ownership of mailboxes
+         unless required (such as when creating a new mailbox).  A MUA
+         may remove a mailbox (unless it has nonstandard permissions) in
+         which case the MTA or another MUA must recreate it if needed.
        </p>
 
        <p>
@@ -9304,7 +9334,7 @@ install-info --quiet --remove /usr/share/info/foobar.info
          </example>
          To view the copyright file for a package you could use this command:
          <example>
-  dpkg --fsys-tarfile <var>filename</var>.deb | tar xOf - \*/copyright | pager
+  dpkg --fsys-tarfile <var>filename</var>.deb | tar xOf - --wildcards \*/copyright | pager
          </example>
        </p>
       </sect>
index ca0350b987b528c09f41cb8bc72646832f884f7b..4cb1c61463d3652826b7929ce47951bc4327f68d 100644 (file)
@@ -58,6 +58,8 @@ picking your way through this list.
        start the daemon again if it's already running.           [9.3.2]
      * /bin/sh scripts may assume that local can take multiple variable
        arguments and supports assignment.                        [10.4]
+     * User mailboxes may be mode 600 and owned by the user rather than
+       mode 660, owned by user, and group mail.                  [11.6]
 
 3.8.0.0                        Jun 2008