changeset:   87881:bc21da9727ad
parent:      87879:03e875beda37
parent:      87880:16b7536e418b
user:        Nick Coghlan <ncoghlan@gmail.com>
date:        Tue Dec 10 21:31:14 2013 +1000
description:
Issue #19407: merge PPUG notes from 3.3


diff -r 03e875beda37 -r bc21da9727ad Doc/distutils/index.rst
--- a/Doc/distutils/index.rst	Tue Dec 10 12:20:14 2013 +0100
+++ b/Doc/distutils/index.rst	Tue Dec 10 21:31:14 2013 +1000
@@ -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 -r 03e875beda37 -r bc21da9727ad Doc/extending/index.rst
--- a/Doc/extending/index.rst	Tue Dec 10 12:20:14 2013 +0100
+++ b/Doc/extending/index.rst	Tue Dec 10 21:31:14 2013 +1000
@@ -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 -r 03e875beda37 -r bc21da9727ad Doc/install/index.rst
--- a/Doc/install/index.rst	Tue Dec 10 12:20:14 2013 +0100
+++ b/Doc/install/index.rst	Tue Dec 10 21:31:14 2013 +1000
@@ -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: