[issue15339] document the threading "facts of life" in Python

[Irit Katriel]

Change by Irit Katriel :


--
priority: low -> normal
stage:  -> needs patch
type:  -> behavior
versions: +Python 3.10, Python 3.9 -Python 2.7, Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Gregory P. Smith]

Gregory P. Smith added the comment:

This seems somewhat related to the "We need to document Python's concurrency 
and memory model" that came out at the language summit this year.

--
nosy: +gregory.p.smith

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Raymond Hettinger]

Changes by Raymond Hettinger :


--
assignee: rhettinger -> 

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[xiaobing jiang]

Changes by xiaobing jiang :


--
nosy: +s7v7nisla...@gmail.com

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Nick Coghlan]

Nick Coghlan  added the comment:

Given the scope of the issue, a concurrent programming howto that lists some of 
the available options and the caveats associated with each of them seems 
worthwhile.

--
nosy: +ncoghlan

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Tshepang Lekhonkhobe]

Changes by Tshepang Lekhonkhobe :


--
nosy: +tshepang

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Raymond Hettinger]

Raymond Hettinger  added the comment:

If no one gets to it first, I'll write-up a draft when I get a chance.

--
assignee: docs@python -> rhettinger
nosy: +rhettinger
priority: normal -> low

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Antoine Pitrou]

Antoine Pitrou  added the comment:

This sounds like a good idea. Either a HOWTO or a FAQ would sound appropriate.

--
nosy: +pitrou
versions: +Python 2.7, Python 3.2, Python 3.3

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue15339] document the threading "facts of life" in Python

[Chris Jerdonek]

New submission from Chris Jerdonek :

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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com