From 6333e56630a603c2629ed0348d6ccef440d0a714 Mon Sep 17 00:00:00 2001 From: Scott Kitterman <kitterma@dell-desktop> Date: Mon, 21 Jun 2010 13:35:02 -0400 Subject: [PATCH] - Define policy for expressing Python and Python 3 versions in XS-Python-Version modified: debian/changelog debian/python-policy.sgml --- debian/changelog | 9 ++++++++- debian/python-policy.sgml | 17 ++++++++++++++--- 2 files changed, 22 insertions(+), 4 deletions(-) diff --git a/debian/changelog b/debian/changelog index 99d0261..db60b49 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,8 +1,15 @@ python-defaults (2.6.5-4) UNRELEASED; urgency=low + [ Piotr Ożarowski ] * dh_python2: fix parsing "XS-Python-Version: X.Y" - -- Piotr Ożarowski <piotr@debian.org> Fri, 18 Jun 2010 16:52:21 +0200 + [ Scott Kitterman ] + * Additonal Python 3 related policy changes: + - Clarify that helper specific policy does not apply to Python 3 + - Define policy for expressing Python and Python 3 versions in + XS-Python-Version + + -- Scott Kitterman <scott@kitterman.com> Sun, 20 Jun 2010 16:13:24 -0400 python-defaults (2.6.5-3) unstable; urgency=low diff --git a/debian/python-policy.sgml b/debian/python-policy.sgml index 2542109..ba04409 100644 --- a/debian/python-policy.sgml +++ b/debian/python-policy.sgml @@ -438,24 +438,35 @@ import foo in the general paragraph (the first one, for the source package) of <file>debian/control</file> specifies the versions of Python supported by the source package. When not specified, it defaults to - all currently supported Python versions. - + all currently supported Python versions (Note: This does not include any + Python 3 versions). + </p> + <p> + It is used to express both Python and Python 3 versions. Support for + Python 3 versions cannot be implicitly defined, it must always be + explicit. It is not necessary to express <tt><< 3.0</tt> because this is + always true when Python versions are specified. + </p> + <p> It is notably used to track packages during Python transitions, and is also used by some packaging scripts to automatically generate appropriate Depends and Provides lines. The format of the field may be one of the following: <example> XS-Python-Version: >= X.Y +XS-Python-Version: >= 2.Y, >= 3.Y XS-Python-Version: >= A.B, << X.Y XS-Python-Version: A.B, X.Y XS-Python-Version: all +XS-Python-Version: all, >= 3.1 </example> The keyword "all" means that the package supports any Python version available but might be deprecated in the future since using version numbers is clearer than "all" and encodes more information. The keyword "all" is limited to Python versions and must be ignored for Python 3 versions. - + </p> + <p> The keyword "current" has been deprecated and used to mean that the package would only have to support a single version (even across default version changes). It must be ignored for Python 3 -- GitLab