diff --git a/debian/changelog b/debian/changelog index 5001ffd7117314489a63a7401297413ae5046b8b..03fbcf8b7562a54292149865dac8fd688eafb53a 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,11 +1,12 @@ -python-defaults (2.7.6-1) UNRELEASED; urgency=medium +python-defaults (2.7.6-1) unstable; urgency=medium * Bump version to 2.7.6. * dh_python2: no longer move files to /usr/share/pyshared, don't create /usr/lib/pyshared symlinks for extensions. * Use UTF-8 encoding for the python policy in HTML format. Closes: #689931. + * Add a chapter for the python policy to prefer Python 3 over Python 2. - -- Matthias Klose <doko@debian.org> Wed, 07 May 2014 14:40:27 +0200 + -- Matthias Klose <doko@debian.org> Mon, 12 May 2014 12:16:34 +0200 python-defaults (2.7.5-5) unstable; urgency=low diff --git a/debian/python-policy.sgml b/debian/python-policy.sgml index 371b13a19030d35866c059624c3ed8b25c73518e..e1337061a4f5bac23ea1539b40dc731c7e5aaa7f 100644 --- a/debian/python-policy.sgml +++ b/debian/python-policy.sgml @@ -32,7 +32,7 @@ <name>Scott Kitterman</name> <email>scott@kitterman.com</email> </author> - <version>version 0.9.4.2</version> + <version>version 0.9.5</version> <abstract> This document describes the packaging of Python within the @@ -42,8 +42,7 @@ <copyright> <copyrightsummary> - Copyright © 1999, 2001, 2003, 2006, 2009, 2010, 2011, 2012 - Software in the Public Interest + Copyright © 1999—2014 Software in the Public Interest </copyrightsummary> <p> This manual is free software; you can redistribute it and/or @@ -74,6 +73,58 @@ <toc detail="sect1"> + <chapt id="python3"> + <heading>On the move to Python 3</heading> + <p> + Debian currently supports two Python stacks, one for Python 2 + and one for Python 3. The long term goal for Debian is to + reduce this to one stack, dropping the Python 2 stack at some + time. + <url id="http://legacy.python.org/dev/peps/pep-0404/" + name="PEP 404"> states that no more major Python 2 releases + are planned, although the last released major version 2.7 + will see some extended support, documented in + <url id="http://legacy.python.org/dev/peps/pep-0466/" + name="PEP 466">. + </p> + <p> + Packages in Debian should use Python 3 if Python 3 is + supported. New packages should use Python 3 from the initial + upload, new upstream versions for existing packages should + use Python 3 if the new upstream version supports it. + </p> + + <p><enumlist> + <item> + <p> + Programs should use Python 3, and should not be packaged + for Python 2 as well. Python 3 should be used for the + packaging if the packaging scripts use Python. + </p> + </item> + <item> + <p> + Python libraries should be always packaged for Python 3 + if supported. Python 2 libraries should be packaged, if + applications found in the reverse dependencies are not + yet supported by Python 3. + </p> + </item> + <item> + <p> + Existing Python 2 libraries should not be dropped before + the last reverse dependency is removed. + </p> + </item> + </enumlist></p> + + <p> + Python 3 (3.1) was released in June 2009, and is available in + the Debian 6.0 (squeeze) release (3.1), and in the Debian 7 + (wheezy) release (3.2). + </p> + </chapt> + <chapt id="python"> <heading>Python Packaging</heading> <sect id="versions"> @@ -117,7 +168,10 @@ <p> The set of currently supported python versions can be found in - <file>/usr/share/python/debian_defaults</file>. This file is in + <file>/usr/share/python/debian_defaults</file>, the set of + currently supported python3 versions can be found + in <file>/usr/share/python3/debian_defaults</file>. These + files are in Python ConfigParser format and defines four variables in its DEFAULT section: default-version which is the current default Python runtime, supported-versions which is the set of runtimes