[issue39534] Clarify tutorial on return statement in finally clause.

[Julien Palard]

Change by Julien Palard :


--
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[miss-islington]

miss-islington  added the comment:


New changeset 97e00b3c52796cb54dd0a50548760579b9cb7b3a by Miss Islington (bot) 
in branch '3.8':
bpo-39534: Doc: Clarify return in finally (GH-18324)
https://github.com/python/cpython/commit/97e00b3c52796cb54dd0a50548760579b9cb7b3a


--

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[miss-islington]

miss-islington  added the comment:


New changeset 83efed9eba9e50ed2395bd3366c31628b9555b1e by Miss Islington (bot) 
in branch '3.7':
bpo-39534: Doc: Clarify return in finally (GH-18324)
https://github.com/python/cpython/commit/83efed9eba9e50ed2395bd3366c31628b9555b1e


--
nosy: +miss-islington

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[miss-islington]

Change by miss-islington :


--
pull_requests: +17761
pull_request: https://github.com/python/cpython/pull/18387

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[Julien Palard]

Julien Palard  added the comment:


New changeset 446463f8dbce0556be8020914f37089b63bb8ab6 by Julien Palard in 
branch 'master':
bpo-39534: Doc: Clarify return in finally (GH-18324)
https://github.com/python/cpython/commit/446463f8dbce0556be8020914f37089b63bb8ab6


--

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[miss-islington]

Change by miss-islington :


--
pull_requests: +17760
pull_request: https://github.com/python/cpython/pull/18386

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[Julien Palard]

Change by Julien Palard :


--
keywords: +patch
pull_requests: +17697
stage:  -> patch review
pull_request: https://github.com/python/cpython/pull/18324

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[STINNER Victor]

Change by STINNER Victor :


--
nosy: +BTaskaya

___
Python tracker 

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

[issue39534] Clarify tutorial on return statement in finally clause.

[Julien Palard]

New submission from Julien Palard :

According to [1][2] the documentation about return in finally statement is 
missleading in [3].

It currently states:

> If a finally clause includes a return statement, the finally clause’s return 
> statement will execute before, and instead of, the return statement in a try 
> clause.

I would prefer speaking about returned values instead of statements executed, I 
think it would clarify the point.


[1]: 
https://mail.python.org/archives/list/d...@python.org/message/LBMO47JSDPKFKLYR25HAKD7A76D5IHWI/
[2]: 
https://stackoverflow.com/questions/59639733/python-docs-have-misleading-explanation-of-return-in-finally
[3]: https://docs.python.org/3.7/tutorial/errors.html#defining-clean-up-actions

--
assignee: mdk
components: Documentation
messages: 361269
nosy: mdk
priority: normal
severity: normal
status: open
title: Clarify tutorial on return statement in finally clause.
type: enhancement
versions: Python 3.7, Python 3.8, Python 3.9

___
Python tracker 

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