Hi, On Thu, May 28 2009, Russ Allbery wrote: > 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>
Seconded. manoj -- People with narrow minds usually have broad tongues. Manoj Srivastava <sriva...@debian.org> <http://www.debian.org/~srivasta/> 1024D/BF24424C print 4966 F272 D093 B493 410B 924B 21BA DABB BF24 424C -- To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org