diff --git a/debian/changelog b/debian/changelog index 99d026166931aa43530be9b628e5f63243241684..db60b49d32229c0f626841adede5671eeb036f4b 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 25421091a50cf40a354b004ee659443ff30a3047..ba044096b6052bb8d2db9429b43b04709d927ad4 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