From ebea6fae86f4217b9515f93dc3169b219fc4222e Mon Sep 17 00:00:00 2001 From: Raymond Hettinger Date: Sun, 5 Sep 2010 00:27:25 +0000 Subject: Update whatsnew for Pep3149. --- Doc/whatsnew/3.2.rst | 31 +++++++++++++++++++++++++++---- 1 file changed, 27 insertions(+), 4 deletions(-) diff --git a/Doc/whatsnew/3.2.rst b/Doc/whatsnew/3.2.rst index c19c094..8484c65 100644 --- a/Doc/whatsnew/3.2.rst +++ b/Doc/whatsnew/3.2.rst @@ -105,12 +105,35 @@ aspects that are visible to the programmer: :pep:`3147` - PYC Repository Directories PEP written by Barry Warsaw. -PEPs -==== +PEP 3149 ABI Version Tagged .so Files +===================================== + +The PYC repository directory allows multiple bytecode cache files to be +co-located. This PEP implements a similar mechanism for shared object files by +giving them a common directory and distinct names for each version. + +The common directory is "pyshared" and the file names are made distinct by +identifying the Python implementation (such as CPython, PyPy, Jython, etc.), the +major and minor version numbers, and optional build flags (such as "d" for +debug, "m" for pymalloc, "u" for wide-unicode). For an arbtrary package, "foo", +you may see these files when the distribution package is installed:: + + /usr/share/pyshared/foo.cpython-32m.so + /usr/share/pyshared/foo.cpython-33md.so -Implemented PEPs: +In Python itself, the tags are accessible from functions in the :mod:`sysconfig` +module:: -* :pep:`3149` + >>> import sysconfig + >>> sysconfig.get_config_var('SOABI') # find the version tag + 'cpython-32mu' + >>> sysconfig.get_config_var('SO') # find the full filename extension + 'cpython-32mu.so' + +.. seealso:: + + :pep:`3149` - ABI Version Tagged .so Files + PEP written by Barry Warsaw. Other Language Changes -- cgit v0.12