From fa919eb901afa4461ea3f551c29c16e1e6ef1ab2 Mon Sep 17 00:00:00 2001
From: Scott Kitterman <scott@kitterman.com>
Date: Mon, 15 Feb 2016 17:35:16 -0500
Subject: [PATCH] Clarify python as an interpreter name is not python3 Add
short section on setuptools
---
debian/python-policy.sgml | 17 ++++++++++++++++-
1 file changed, 16 insertions(+), 1 deletion(-)
diff --git a/debian/python-policy.sgml b/debian/python-policy.sgml
index ef4346b..b5357bb 100644
--- a/debian/python-policy.sgml
+++ b/debian/python-policy.sgml
@@ -308,7 +308,7 @@
<p>
Python scripts may specify <file>python</file> as the
interpreter name only if they do not require any particular
- version of Python.
+ version of Python. (Note: this means any python2 version)
</p>
<p>
Python scripts that only work with a specific Python minor
@@ -983,6 +983,21 @@ Build-Depends: python3-all-dev (>= 3.2)
</p>
</sect>
+ <sect id="setuptools">
+ <heading>setuptools</heading>
+ <p>
+ The related Python <tt>setuptools</tt> module has been modified in
+ Debian along the same lines as <tt>distutils</tt>.
+ </p>
+ <p>
+ Upstream focus on developments and improvements for Python packaging
+ tools has largely shifted away from <tt>distutils</tt> and to
+ <tt>setuptools</tt>. They offer a similar API and at some point in
+ the future, <tt>setuptools</tt> may fully replace <tt>distutils</tt>
+ in Debian package builds.
+ </p>
+ </sect>
+
<sect id="dh-python">
<heading><package>dh-python</package></heading>
<p>
--
GitLab