Update whatsnew for Pep3149.
authorRaymond Hettinger <python@rcn.com>
Sun, 5 Sep 2010 00:27:25 +0000 (00:27 +0000)
committerRaymond Hettinger <python@rcn.com>
Sun, 5 Sep 2010 00:27:25 +0000 (00:27 +0000)
Doc/whatsnew/3.2.rst

index c19c094f72d1ceb35b3bb1bfb291e035901c9411..8484c65e92d57cf3afc05989b1023c3a73052ab9 100644 (file)
@@ -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