summaryrefslogtreecommitdiffstats
path: root/Doc/whatsnew/3.4.rst
diff options
context:
space:
mode:
authorNick Coghlan <ncoghlan@gmail.com>2014-03-13 12:13:45 (GMT)
committerNick Coghlan <ncoghlan@gmail.com>2014-03-13 12:13:45 (GMT)
commitf7614d55a2e1b1c51aebaa8e7ad0ba7951883d9b (patch)
tree7dbcedea7c9fb86a57dd4babdce5fcb411402b76 /Doc/whatsnew/3.4.rst
parent9e0622713e04d6567921b99b62f4651fae6358a6 (diff)
downloadcpython-f7614d55a2e1b1c51aebaa8e7ad0ba7951883d9b.zip
cpython-f7614d55a2e1b1c51aebaa8e7ad0ba7951883d9b.tar.gz
cpython-f7614d55a2e1b1c51aebaa8e7ad0ba7951883d9b.tar.bz2
Close #19407: New installation & distribution guides
- based on pip and other PyPA tools - includes references to the new Python Packaging User Guide where appropriate (and the relevant section is at least partially filled in) - started new FAQ sections - both guides aim to introduce users to basic open source concepts if they aren't aware of them - existing guides have been relocated (now linked from the distutils docs) rather then removed, since there is some needed material that has yet to be relocated to the distutils docs as a reference for the legacy formats
Diffstat (limited to 'Doc/whatsnew/3.4.rst')
-rw-r--r--Doc/whatsnew/3.4.rst19
1 files changed, 19 insertions, 0 deletions
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index 067ff4c0..94b71c5 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -180,6 +180,9 @@ New Expected Features for Python Implementations
PEP 453: Explicit Bootstrapping of PIP in Python Installations
--------------------------------------------------------------
+Bootstrapping pip by default
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
The new :mod:`ensurepip` module (defined in :pep:`453`) provides a standard
cross-platform mechanism to bootstrap the pip installer into Python
installations and virtual environments.
@@ -207,6 +210,22 @@ clear and simple directions on how to install ``pip`` on the platform.
__ http://www.python.org/dev/peps/pep-0453/#recommendations-for-downstream-distributors
+
+Documentation changes
+~~~~~~~~~~~~~~~~~~~~~
+
+As part of this change, the :ref:`installing-index` and
+:ref:`distributing-index` sections of the documentation have been
+completely redesigned as short getting started and FAQ documents. Most
+packaging documentation has now been moved out to the Python Packaging
+Authority maintained `Python Packaging User Guide
+<http://packaging.python.org>`__ and the documentation of the individual
+projects.
+
+However, as this migration is currently still incomplete, the legacy
+versions of those guides remaining available as :ref:`install-index`
+and :ref:`distutils-index`.
+
.. note::
To avoid conflicts between parallel Python 2 and Python 3 installations,