traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

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.
This commit is contained in:
Nick Coghlan 2013-12-10 21:24:55 +10:00
parent 1f79cdfbfa
commit b5c4fd0a96
3 changed files with 32 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
Doc/distutils/index.rst
View File

@ -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:

9
Doc/extending/index.rst
View File

@ -21,6 +21,15 @@ Python) that give the language its wide application range.
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:

18
Doc/install/index.rst
View File

@ -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: