cpython: 16b7536e418b (original) (raw)
Mercurial > cpython
changeset 87880:16b7536e418b 3.3
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. [#19407]
| Nick Coghlan ncoghlan@gmail.com | |
|---|---|
| date | Tue, 10 Dec 2013 21:24:55 +1000 |
| parents | 49eb895be796 |
| children | bc21da9727ad 9f38bbd4e041 |
| files | Doc/distutils/index.rst Doc/extending/index.rst Doc/install/index.rst |
| diffstat | 3 files changed, 32 insertions(+), 5 deletions(-)[+] [-] Doc/distutils/index.rst 10 Doc/extending/index.rst 9 Doc/install/index.rst 18 |
line wrap: on
line diff
--- a/Doc/distutils/index.rst +++ b/Doc/distutils/index.rst @@ -12,6 +12,16 @@ the module developer's point of view, de 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:
--- a/Doc/extending/index.rst
+++ b/Doc/extending/index.rst
@@ -21,6 +21,15 @@ Python) that give the language its wide
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:
--- 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.