summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2020-05-28 16:33:04 (GMT)
committerGitHub <noreply@github.com>2020-05-28 16:33:04 (GMT)
commit242d95659b6b4ff4fb54b58a30454dafa311d4e9 (patch)
tree999eef2822752395e230a2c608fe3b669042d6bd /Doc
parentfda7f6d61b13c68f59806db674e892fda4013348 (diff)
downloadcpython-242d95659b6b4ff4fb54b58a30454dafa311d4e9.zip
cpython-242d95659b6b4ff4fb54b58a30454dafa311d4e9.tar.gz
cpython-242d95659b6b4ff4fb54b58a30454dafa311d4e9.tar.bz2
bpo-1294959: Try to clarify the meaning of platlibdir (GH-20332)
Try to make the meaning of platlibdir clear. The previous wording could be misinterpreted to suggest that it will be used to find all shared libraries on the system, and not just Python extensions. Furthermore, it was unclear whether it affects third-party (site-packages) extensions or not. The new wording tries to make its dual purpose clear, and provide the additional example of extensions in site-packages.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/sys.rst7
-rw-r--r--Doc/whatsnew/3.9.rst7
2 files changed, 7 insertions, 7 deletions
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index 98f63fb..880f252 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -1141,8 +1141,7 @@ always available.
.. data:: platlibdir
Name of the platform-specific library directory. It is used to build the
- path of platform-specific dynamic libraries and the path of the standard
- library.
+ path of standard library and the paths of installed extension modules.
It is equal to ``"lib"`` on most platforms. On Fedora and SuSE, it is equal
to ``"lib64"`` on 64-bit platforms which gives the following ``sys.path``
@@ -1153,8 +1152,10 @@ always available.
* ``/usr/lib64/pythonX.Y/lib-dynload/``:
C extension modules of the standard library (like the :mod:`errno` module,
the exact filename is platform specific)
- * ``/usr/lib/pythonX.Y/site-packages`` (always use ``lib``, not
+ * ``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, not
:data:`sys.platlibdir`): Third-party modules
+ * ``/usr/lib64/pythonX.Y/site-packages/``:
+ C extension modules of third-party packages
.. versionadded:: 3.9
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
index a42ec09..6c3cbbe 100644
--- a/Doc/whatsnew/3.9.rst
+++ b/Doc/whatsnew/3.9.rst
@@ -552,10 +552,9 @@ sys
---
Add a new :attr:`sys.platlibdir` attribute: name of the platform-specific
-library directory. It is used to build the path of platform-specific dynamic
-libraries and the path of the standard library. It is equal to ``"lib"`` on
-most platforms. On Fedora and SuSE, it is equal to ``"lib64"`` on 64-bit
-platforms.
+library directory. It is used to build the path of standard library and the
+paths of installed extension modules. It is equal to ``"lib"`` on most
+platforms. On Fedora and SuSE, it is equal to ``"lib64"`` on 64-bit platforms.
(Contributed by Jan Matějek, Matěj Cepl, Charalampos Stratakis and Victor Stinner in :issue:`1294959`.)
Previously, :attr:`sys.stderr` was block-buffered when non-interactive. Now