New submission from Chris Jerdonek <chris.jerdo...@gmail.com>:

I think it would be helpful if the Python documentation included certain 
high-level information about multi-threading in Python.

At minimum, I think it would help for the documentation to provide a definition 
that can be linked to of what it means when some part of the Python 
documentation says something is "thread-safe".  In particular, such a 
definition could clarify that this is different from being atomic.  This might 
best be addressed by an entry in the glossary for the term "thread-safe".
  
Other documentation possibilities include stating what guarantees one should or 
should not expect regarding thread-safety, both within and across 
implementations, and providing centralized guidance on how to approach 
multi-threaded programming in Python.  A HOWTO is one possibility for 
addressing these other possibilities.

This issue stems from the discussion in issue 15329, which is more specific.

----------
assignee: docs@python
components: Documentation
messages: 165336
nosy: cjerdonek, docs@python
priority: normal
severity: normal
status: open
title: document the threading "facts of life" in Python

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue15339>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to