summaryrefslogtreecommitdiffstats
path: root/Doc/distutils/index.rst
diff options
context:
space:
mode:
authorNick Coghlan <ncoghlan@gmail.com>2013-12-10 11:24:55 (GMT)
committerNick Coghlan <ncoghlan@gmail.com>2013-12-10 11:24:55 (GMT)
commitb5c4fd0a964ec7d67e564e9e4a623d8b45aafa6b (patch)
treea482eb3b4f001aadc23e5a96c475f53b1126b2e9 /Doc/distutils/index.rst
parent1f79cdfbfa3f53fb1aa3bb8998c463a5d2614795 (diff)
downloadcpython-b5c4fd0a964ec7d67e564e9e4a623d8b45aafa6b.zip
cpython-b5c4fd0a964ec7d67e564e9e4a623d8b45aafa6b.tar.gz
cpython-b5c4fd0a964ec7d67e564e9e4a623d8b45aafa6b.tar.bz2
Issue #19407: add Python Packaging User Guide notes
The stdlib docs for package distribution and building extensions are rather dated, and that isn't expected to change for 2.7 and 3.3. The Python Packaging User Guide isn't complete either, but it's already a much better road map for new users than the existing stdlib docs.
Diffstat (limited to 'Doc/distutils/index.rst')
-rw-r--r--Doc/distutils/index.rst10
1 files changed, 10 insertions, 0 deletions
diff --git a/Doc/distutils/index.rst b/Doc/distutils/index.rst
index 1cd5f3c..1a6f04c 100644
--- a/Doc/distutils/index.rst
+++ b/Doc/distutils/index.rst
@@ -12,6 +12,16 @@ the module developer's point of view, describing how to use the Distutils to
make Python modules and extensions easily available to a wider audience with
very little overhead for build/release/install mechanics.
+.. note::
+
+ This guide only covers the basic tools for building and distributing
+ extensions that are provided as part of this version of Python. Third
+ party tools offer easier to use and more secure alternatives. Refer to the
+ `quick recommendations section
+ <https://python-packaging-user-guide.readthedocs.org/en/latest/current.html>`__
+ in the Python Packaging User Guide for more information.
+
+
.. toctree::
:maxdepth: 2
:numbered: