Skip to content

Commit 4c796c2

Browse files
committed
Update README for new interpreter layout
1 parent 919f52e commit 4c796c2

File tree

1 file changed

+13
-2
lines changed

1 file changed

+13
-2
lines changed

README.rst

+13-2
Original file line numberDiff line numberDiff line change
@@ -51,14 +51,25 @@ directory for source code.
5151
The images currently contain:
5252

5353
- CPython 2.6, 2.7, 3.3, 3.4, and 3.5, installed in ``/opt/<version
54-
number>``
54+
number><soabi flags>``
5555
- Devel packages for all the libraries that PEP 513 allows you to
5656
assume are present on the host system
5757
- The `auditwheel <https://pypi.python.org/pypi/auditwheel>`_ tool
5858

59+
The "soabi flags" used in naming CPython version directories under ``/opt`` are
60+
`PEP 3149 <https://www.python.org/dev/peps/pep-3149/>`_ ABI flags. Because
61+
wheels created using a CPython (older than 3.3) built with
62+
``--enable-unicode=ucs2`` are not compatible with ``--enable-unicode=ucs4``
63+
interpreters, CPython 2.X builds of both UCS-2 (flags ``m``) and UCS-4 (flags
64+
``mu``) are provided in ``/opt`` since both are commonly found "in the wild."
65+
Other less common or virtually unheard of flag combinations (such as
66+
``--with-pydebug`` (``d``) and ``--without-pymalloc`` (absence of ``m``)) are
67+
not provided.
68+
5969
It'd be good to put an example of how to use these images here, but
6070
that isn't written yet. If you want to know, then bug us on the
61-
mailing list to fill in this section :-).
71+
mailing list to fill in this section :-). However, one useful tip is that a
72+
list of all interpreters can be obtained with ``/opt/python/*/bin/python``.
6273

6374

6475
The PEP itself

0 commit comments

Comments
 (0)