[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#530967: marked as done (Bring Architecture description in line with current dpkg-source)

Your message dated Sun, 16 Aug 2009 00:32:09 +0000
with message-id <E1McTfN-0003wl-05@ries.debian.org>
and subject line Bug#530967: fixed in debian-policy 3.8.3.0
has caused the Debian Bug report #530967,
regarding Bring Architecture description in line with current dpkg-source
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
530967: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=530967
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: debian-policy
Version: 3.8.1.0
Severity: minor
Tags: patch

Based on previous discussion, here are proposed changes to the description
of the Architecture field to bring it in line with recent changes to
dpkg-source and to try to make the whole section clearer.

This patch does not address the addition of architecture wildcards.  I'd
like to take care of this first and then add that patch (and will have
some separate suggestions for it).

diff --git a/policy.sgml b/policy.sgml
index 144cbfb..52e7e24 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -2710,7 +2710,7 @@ Package: libc6
 	    values:
 	    <list>
 		<item>A unique single word identifying a Debian machine
-		      architecture, see <ref id="arch-spec">.
+		      architecture as described in <ref id="arch-spec">.
 		<item><tt>all</tt>, which indicates an
 		      architecture-independent package.
 		<item><tt>any</tt>, which indicates a package available
@@ -2721,31 +2721,53 @@ Package: libc6
 
 	  <p>
 	    In the main <file>debian/control</file> file in the source
-	    package, or in the source package control file
-	    <file>.dsc</file>, one may specify a list of architectures
-	    separated by spaces, or the special values <tt>any</tt> or
-	    <tt>all</tt>.
+	    package, this field may contain the special value
+	    <tt>any</tt>, the special value <tt>all</tt>, or a list of
+	    architectures separated by spaces.	If <tt>any</tt> or
+	    <tt>all</tt> appear, they must be the entire contents of the
+	    field.  Most packages will use either <tt>any</tt> or
+	    <tt>all</tt>.  Specifying a specific list of architectures is
+	    for the minority of cases where a program is not portable or
+	    is not useful on some architectures, and where possible the
+	    program should be made portable instead.
+	  </p>
+
+	  <p>
+	    In the source package control file <file>.dsc</file>, this
+	    field may contain either the special value <tt>any</tt> or a
+	    list of architectures separated by spaces. If a list is given,
+	    it may include (or consist solely of) the special value
+	    <tt>all</tt>.  In other words, in <file>.dsc</file> files
+	    unlike the <file>debian/control</file>, <tt>all</tt> may occur
+	    in combination with specific architectures.  The
+	    <tt>Architecture</tt> field in the source package control file
+	    <file>.dsc</file> is generally constructed from the
+	    <tt>Architecture</tt> fields in the
+	    <file>debian/control</file> in the source package.
 	  </p>
 
 	  <p>
 	    Specifying <tt>any</tt> indicates that the source package
 	    isn't dependent on any particular architecture and should
 	    compile fine on any one. The produced binary package(s)
-	    will be specific to whatever the current build architecture
-	    is.<footnote>
-		This is the most often used setting, and is recommended
-		for new packages that aren't <tt>Architecture: all</tt>.
-	    </footnote>
+	    will either be specific to whatever the current build
+	    architecture is or will be architecture-independent.
+	  </p>
+
+	  <p>
+	    Specifying only <tt>all</tt> indicates that the source package
+	    will only build architecture-independent packages.  If this is
+	    the case, <tt>all</tt> must be used rather than <tt>any</tt>;
+	    <tt>any</tt> implies that the source package will build at
+	    least one architecture-dependent package.
 	  </p>
 
 	  <p>
 	    Specifying a list of architectures indicates that the source
 	    will build an architecture-dependent package, and will only
-	    work correctly on the listed architectures.<footnote>
-		This is a setting used for a minority of cases where the
-		program is not portable. Generally, it should not be used
-		for new packages.
-	    </footnote>
+	    work correctly on the listed architectures.  If the source
+	    package also builds at least one architecture-independent
+	    package, <tt>all</tt> will also be included in the list.
 	  </p>
 
 	  <p>
@@ -2753,7 +2775,11 @@ Package: libc6
 	    field lists the architecture(s) of the package(s)
 	    currently being uploaded.  This will be a list; if the
 	    source for the package is also being uploaded, the special
-	    entry <tt>source</tt> is also present.
+	    entry <tt>source</tt> is also present.  <tt>all</tt> will be
+	    present if any architecture-independent packages are being
+	    uploaded.  <tt>any</tt> may never occur in the
+	    <tt>Architecture</tt> field in the <file>.changes</file>
+	    file.
 	  </p>
 
 	  <p>

--- End Message ---
--- Begin Message --- 
Source: debian-policy
Source-Version: 3.8.3.0

We believe that the bug you reported is fixed in the latest version of
debian-policy, which is due to be installed in the Debian FTP archive:

debian-policy_3.8.3.0.dsc
  to pool/main/d/debian-policy/debian-policy_3.8.3.0.dsc
debian-policy_3.8.3.0.tar.gz
  to pool/main/d/debian-policy/debian-policy_3.8.3.0.tar.gz
debian-policy_3.8.3.0_all.deb
  to pool/main/d/debian-policy/debian-policy_3.8.3.0_all.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 530967@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Russ Allbery <rra@debian.org> (supplier of updated debian-policy package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.8
Date: Sat, 15 Aug 2009 17:13:26 -0700
Source: debian-policy
Binary: debian-policy
Architecture: source all
Version: 3.8.3.0
Distribution: unstable
Urgency: low
Maintainer: Debian Policy List <debian-policy@lists.debian.org>
Changed-By: Russ Allbery <rra@debian.org>
Description: 
 debian-policy - Debian Policy Manual and related documents
Closes: 493007 514919 519941 522217 525190 527871 529771 530967 533577 533852 534408 537707 538665 539389 541537
Changes: 
 debian-policy (3.8.3.0) unstable; urgency=low
 .
   * Policy: Bring Architecture description in line with dpkg-source
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Raphael Hertzog <hertzog@debian.org>
     Seconded: Manoj Srivastava <srivasta@debian.org>
     Closes: #530967
   * Policy: Update information about DEB_*_ARCH variables
     Wording: Guillem Jover <guillem@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Seconded: Andrew McMillan <andrew@morphoss.com>
     Closes: #527871
   * Policy: Remove support for uploads to multiple distributions
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Raphael Hertzog <hertzog@debian.org>
     Seconded: Manoj Srivastava <srivasta@debian.org>
     Closes: #514919
   * Policy: Remove permission for packages to modify ld.so.conf
     Wording: Steve Langasek <vorlon@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Seconded: Kurt Roeckx <kurt@roeckx.be>
     Seconded: Adeodato Simó <dato@net.com.org.es>
     Seconded: Julien Cristau <jcristau@debian.org>
     Closes: #519941
   * Policy: Clarify X installation directory handling
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Julien Cristau <jcristau@debian.org>
     Seconded: Manoj Srivastava <srivasta@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #522217
   * Policy: Localized man pages should be up-to-date or warn
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Julien Cristau <jcristau@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #493007
   * Policy: Remove restriction on manual page character encoding
     Wording: Colin Watson <cjwatson@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Seconded: Manoj Srivastava <srivasta@golden-gryphon.com>
     Closes: #537707
   * Policy: Allow Binary field to span multiple lines
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Julien Cristau <jcristau@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Closes: #533852
   * Policy: Revise info requirements for triggerized install-info
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #538665
   * Perl Policy: Remove obsolete dependency requirements
     Wording: Cyril Brulebois <kibi@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Seconded: Manoj Srivastava <srivasta@debian.org>
     Closes: #525190
   * Breaks is now supported by the stable release of dpkg, so drop
     warnings against its use.  Thanks, Steve Langasek.  (Closes: #533577)
   * Add references to the sections on Breaks and Conflicts to the section
     on binary dependencies.  Thanks, Frank Küster.  (Closes: #529771)
   * Clarify the units of Installed-Size and document that it is an
     approximation.  Thanks, Martin Dorey.  (Closes: #534408)
   * Don't suggest calling dpkg-statoverride --remove unconditionally in
     the postrm script.  Thanks, Patrick Schoenfeld.  (Closes: #539389)
   * 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)
   * Clarify the description of the Files control field and add examples.
   * 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.
   * Merge the package name syntax requirements between the Package and
     Source field descriptions.
   * 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)
   * Document that control field values are case-sensitive unless the field
     description says otherwise.
Checksums-Sha1: 
 55a18b31606a3e4126895c3c1d26ce2b72f34e5d 1194 debian-policy_3.8.3.0.dsc
 5955ff2079fbc7aa700e7c1073ce76cc456633eb 650740 debian-policy_3.8.3.0.tar.gz
 79049f64018b7baa0ef03495b9cd36188849adfc 1607738 debian-policy_3.8.3.0_all.deb
Checksums-Sha256: 
 d4e0a4739ca5851c1099bb657b7c802c6087a5196a914a031149bc6726e25289 1194 debian-policy_3.8.3.0.dsc
 2b9ca60381f16383ff5fc86313b88dc1fc3c8b2c3375dd7eb86dc7d67a2d1722 650740 debian-policy_3.8.3.0.tar.gz
 b4d662ea3b22b81b08bc1334c65c100cd1979ec3976a7f4e66c7d6e06c98f155 1607738 debian-policy_3.8.3.0_all.deb
Files: 
 b7811d713a26d8904ca6160245b5a356 1194 doc optional debian-policy_3.8.3.0.dsc
 24a27ad230f789ef808cd32147e2229b 650740 doc optional debian-policy_3.8.3.0.tar.gz
 f0d3d90b31aa5a0ce230882b81d3fe9c 1607738 doc optional debian-policy_3.8.3.0_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkqHUhwACgkQ+YXjQAr8dHYbcQCgkBMCelcn21KA99jMOjbK/HI/
mToAoK0BWtXtKWBfxiCxCHCdStIszfUm
=swfU
-----END PGP SIGNATURE-----

--- End Message ---
Reply to: