* Add a chapter for the python policy to prefer Python 3 over Python 2.

debian/changelog

-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
 

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 &copy; 1999, 2001, 2003, 2006, 2009, 2010, 2011, 2012
-	  Software in the Public Interest
+	  Copyright &copy; 1999&mdash;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