New submission from R. David Murray:

The get_stack method docs say:

"If the coroutine is active, returns the stack where it was suspended."

I presume this means something more like "if the coroutine is not done...", 
since in English you can't be both active *and* suspended.  Or does it mean 
"last suspended"?

Then it talks about limit and how stacks limit returns newest frames while with 
tracebacks it is oldest frames...but the last sentence says that for suspended 
coroutines only one frame is returned.

So there is a definite lack of clarity here: can we get multiple frames if the 
coroutine is not suspended (in which case that first sentence seems likely to 
be the 'last suspended' interpretation), or for non-tracebacks can we only ever 
get one frame, in which case why talk about limit returning the newest frames 
for stacks?

----------
assignee: docs@python
components: Documentation
messages: 227401
nosy: docs@python, r.david.murray
priority: normal
severity: normal
status: open
title: asyncio task get_stack documentation seems to contradict itself
type: behavior
versions: Python 3.4, Python 3.5

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

Reply via email to