summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorR David Murray <rdmurray@bitdance.com>2014-03-13 23:53:38 (GMT)
committerR David Murray <rdmurray@bitdance.com>2014-03-13 23:53:38 (GMT)
commitbcf7012d19d875587c99e022b333466fa6fd20f1 (patch)
treee6c599c4039d2652272cc60096fecaed4297a6ea /Doc
parentf446d7a70b710490c1859046d07d4332ac3b4bad (diff)
downloadcpython-bcf7012d19d875587c99e022b333466fa6fd20f1.zip
cpython-bcf7012d19d875587c99e022b333466fa6fd20f1.tar.gz
cpython-bcf7012d19d875587c99e022b333466fa6fd20f1.tar.bz2
whatsnew: linkify some pip things, and explain why non-inheriting is good.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/venv.rst2
-rw-r--r--Doc/using/unix.rst2
-rw-r--r--Doc/whatsnew/3.4.rst25
3 files changed, 20 insertions, 9 deletions
diff --git a/Doc/library/venv.rst b/Doc/library/venv.rst
index d29a957..e93f48e 100644
--- a/Doc/library/venv.rst
+++ b/Doc/library/venv.rst
@@ -76,6 +76,8 @@ Creating virtual environments
without there needing to be any reference to its venv in ``PATH``.
+.. _venv-api:
+
API
---
diff --git a/Doc/using/unix.rst b/Doc/using/unix.rst
index 40635c6..3c7fc41 100644
--- a/Doc/using/unix.rst
+++ b/Doc/using/unix.rst
@@ -60,6 +60,8 @@ To install the newest Python versions on OpenSolaris, install `blastwave
prompt.
+.. _building-python-on-unix:
+
Building Python
===============
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index f706791..7c4c43a 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -193,15 +193,16 @@ By default, the scripts ``pipX`` and ``pipX.Y`` will be installed (where
X.Y stands for the version of the Python installation), along with the
``pip`` Python package and its dependencies.
-The :mod:`venv` module and the :command:`pyvenv` utility make use of this
-module to make ``pip`` readily available in virtual environments. When
-using the command line interface, ``pip`` is installed by default, while
-for the module API installation of ``pip`` must be requested explicitly.
+The :ref:`pyvenv <scripts-pyvenv>` command line utility and the :mod:`venv`
+module make use of the :mod:`ensurepip` module to make ``pip`` readily
+available in virtual environments. When using the command line utility, ``pip``
+is installed by default, while when using the :mod:`venv` module
+:ref:`venv-api` installation of ``pip`` must be requested explicitly.
-For CPython source builds on POSIX systems, the ``make install`` and
-``make altinstall`` commands bootstrap ``pip`` by default. This behaviour
-can be controlled through configure options, and overridden through
-Makefile options.
+For CPython :ref:`source builds on POSIX systems <building-python-on-unix>`,
+the ``make install`` and ``make altinstall`` commands bootstrap ``pip`` by
+default. This behaviour can be controlled through configure options, and
+overridden through Makefile options.
On Windows and Mac OS X, the CPython installers now offer the option to
install ``pip`` along with CPython itself.
@@ -251,7 +252,13 @@ PEP 446: Newly Created File Descriptors Are Non-Inheritable
-----------------------------------------------------------
:pep:`446` makes newly created file descriptors :ref:`non-inheritable
-<fd_inheritance>`. New functions and methods:
+<fd_inheritance>`. In general, this is the behavior an application will
+want: when launching a new process, having currently open files also
+open in the new process can lead to all sorts of hard to find bugs,
+and potentially to security issues.
+
+However, there are occasions when inheritance is desired. To support
+these cases, the following new functions and methods are available:
* :func:`os.get_inheritable`, :func:`os.set_inheritable`
* :func:`os.get_handle_inheritable`, :func:`os.set_handle_inheritable`