[Python-checkins] cpython (merge 3.3 -> default): Issue #19407: merge PPUG notes from 3.3

Tue Dec 10 12:32:40 CET 2013

http://hg.python.org/cpython/rev/bc21da9727ad
changeset: 87881:bc21da9727ad
parent: 87879:03e875beda37
parent: 87880:16b7536e418b
user: Nick Coghlan <ncoghlan at gmail.com>
date: Tue Dec 10 21:31:14 2013 +1000
summary:
 Issue #19407: merge PPUG notes from 3.3
files:
 Doc/distutils/index.rst | 10 ++++++++++
 Doc/extending/index.rst | 9 +++++++++
 Doc/install/index.rst | 18 +++++++++++++-----
 3 files changed, 32 insertions(+), 5 deletions(-)

diff --git a/Doc/distutils/index.rst b/Doc/distutils/index.rst
--- a/Doc/distutils/index.rst
+++ b/Doc/distutils/index.rst
@@ -12,6 +12,16 @@
 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:
diff --git a/Doc/extending/index.rst b/Doc/extending/index.rst
--- a/Doc/extending/index.rst
+++ b/Doc/extending/index.rst
@@ -21,6 +21,15 @@
 For a detailed description of the whole Python/C API, see the separate
 :ref:`c-api-index`.
 
+.. note::
+
+ This guide only covers the basic tools for creating extensions provided
+ as part of this version of CPython. Third party tools may offer simpler
+ alternatives. Refer to the `binary extensions section
+ <https://python-packaging-user-guide.readthedocs.org/en/latest/extensions.html>`__
+ in the Python Packaging User Guide for more information.
+
+
 .. toctree::
 :maxdepth: 2
 :numbered:
diff --git a/Doc/install/index.rst b/Doc/install/index.rst
--- a/Doc/install/index.rst
+++ b/Doc/install/index.rst
@@ -20,12 +20,20 @@
 Finally, it might be useful to include all the material from my "Care
 and Feeding of a Python Installation" talk in here somewhere. Yow!
 
-.. topic:: Abstract
+This document describes the Python Distribution Utilities ("Distutils") from the
+end-user's point-of-view, describing how to extend the capabilities of a
+standard Python installation by building and installing third-party Python
+modules and extensions.
 
- This document describes the Python Distribution Utilities ("Distutils") from the
- end-user's point-of-view, describing how to extend the capabilities of a
- standard Python installation by building and installing third-party Python
- modules and extensions.
+
+.. note::
+
+ This guide only covers the basic tools for installing 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.
 
 
 .. _inst-intro:
-- 
Repository URL: http://hg.python.org/cpython
