diff --git a/debian/python-policy.sgml b/debian/python-policy.sgml index ef4346bf017678c83309ec90f298b90198c3d3b2..b5357bb525fe4d1138fd60894d9ff0fd4f8c2656 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>