Bug#622263: debian-policy: Phrasing of 5.6.25 (DMUA) is confusing
Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr> writes:
> On Mon, Apr 11, 2011 at 04:54:04PM +0200, Didier Raboud wrote:
>> We just had a short discussion on IRC (#debian-python, 2011-04-11)
>> about the phrasing of the new 5.6.25 paragraph (which documents the
>> DMUA field).
>> The current phrasing makes it sound that adding the DM-Upload-Allowed
>> field to each source package is required (where AFAIK it isn't).
>> I propose the following rephrasing:
>> --- policy_orig.sgml 2011-04-11 16:33:25.000000000 +0200
>> +++ policy.sgml 2011-04-11 16:45:52.000000000 +0200
>> @@ -3700,11 +3700,11 @@
>> <heading><tt>DM-Upload-Allowed</tt></heading>
>>
>> <p>
>> - - The most recent version of a package uploaded to unstable or
>> - - experimental must include the field <tt>DM-Upload-Allowed:
>> - - yes</tt> in the source section of its source control file for
>> - - the Debian archive to accept uploads signed with a key in the
>> - - Debian Maintainer keyring. See the General
>> + The Debian archive will accept uploads signed with a key in
>> + the Debian Maintainer keyring for a given package if and only
>> + if the previous upload of said package had the
>> + <tt>DM-Upload-Allowed: yes</tt> field included in the source
>> + section of its source control file. See the General
>> Resolution <url id="http://www.debian.org/vote/2007/vote_003";
>> name="Endorse the concept of Debian Maintainers"> for more
>> details.
> I am not sure I find this version anymore clear. Maybe
> + If <tt>DM-Upload-Allowed:</tt> is set to <tt>yes</tt>, the Debian
> + archive will accept subsequent uploads of the package to be signed
> + with a key in the Debian Maintainer keyring instead of the Debian
> + Developper keyring. See the General
I'm applying the following change for the next release, which I think
reorganizes the text to make it much clearer.
diff --git a/policy.sgml b/policy.sgml
index 2c0c72a..5a8de36 100644
--- a/policy.sgml
+++ b/policy.sgml
@@ -3725,11 +3725,13 @@ Checksums-Sha256:
<heading><tt>DM-Upload-Allowed</tt></heading>
<p>
- The most recent version of a package uploaded to unstable or
- experimental must include the field <tt>DM-Upload-Allowed:
- yes</tt> in the source section of its source control file for
- the Debian archive to accept uploads signed with a key in the
- Debian Maintainer keyring. See the General
+ Indicates that Debian Maintainers may upload this package to
+ the Debian archive. The only valid value is <tt>yes</tt>. If
+ the field <tt>DM-Upload-Allowed: yes</tt> is present in the
+ source section of the source control file of the most recent
+ version of a package in unstable or experimental, the Debian
+ archive will accept uploads of this package signed with a key
+ in the Debian Maintainer keyring. See the General
Resolution <url id="http://www.debian.org/vote/2007/vote_003";
name="Endorse the concept of Debian Maintainers"> for more
details.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: