[docs] Threading CIL CPython

Josh Kinnison kinnison.josh at gmail.com
Thu May 17 15:18:17 CEST 2012


http://docs.python.org/library/threading.html#module-threading

The docs for threading present that CIL limitation in a poor way.  "CPython
implementation detail" as a title translates quickly into "not relevant",
especially for readers unfamiliar with CPython (how many uses would
incorrectly guess that they use "regular Python", not this "CPython
thing"?).  A stronger title like "Limitation for multiple cores" would
help.  Avoiding the term CPython or at least clarifying that this is the
default Python would also help.  The details of the limitation are
interesting, but shouldn't be at the forefront of documentation.

Thankfully, multiprocessing has the same API for the most part.  So aside
from the time spent wondering why the threads arent spreading to cover all
their cores,  it shouldn't be a big problem for most.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20120517/4b359afb/attachment.html>


More information about the docs mailing list