Document that return-less user-defined functions return None #126769
Conversation
bedevere-app
bot
added
docs
|
What would be particularly useful from more experienced Pythonistas would be an indication of whether they think this addition is necessary or a pointer to where this is already documented in the reference documentation (if it is). (And if it's not already documented somewhere, confirmation that it is actually true!) ETA: I see it appears in the description of None. |
|
Tutorial https://docs.python.org/3/tutorial/controlflow.html#defining-functions has a mention that the function without return returns |
|
Do we want to backport this? |
willingc
added
needs backport to 3.12
Co-authored-by: Carol Willing <[email protected]>
|
Thanks @jmarshall for the PR, and @asvetlov for merging it 🌮🎉.. I'm working now to backport this PR to: 3.12, 3.13. |
…H-126769) (cherry picked from commit e0692f1) Co-authored-by: John Marshall <[email protected]> Co-authored-by: Andrew Svetlov <[email protected]> Co-authored-by: Carol Willing <[email protected]>
|
GH-126822 is a backport of this pull request to the 3.13 branch. |
…H-126769) (cherry picked from commit e0692f1) Co-authored-by: John Marshall <[email protected]> Co-authored-by: Andrew Svetlov <[email protected]> Co-authored-by: Carol Willing <[email protected]>
|
GH-126823 is a backport of this pull request to the 3.12 branch. |
…H-126769) (#126823) Document that return-less user-defined functions return None (GH-126769) (cherry picked from commit e0692f1) Co-authored-by: John Marshall <[email protected]> Co-authored-by: Andrew Svetlov <[email protected]> Co-authored-by: Carol Willing <[email protected]>
…H-126769) (#126822) Document that return-less user-defined functions return None (GH-126769) (cherry picked from commit e0692f1) Co-authored-by: John Marshall <[email protected]> Co-authored-by: Andrew Svetlov <[email protected]> Co-authored-by: Carol Willing <[email protected]>
I hunted through Calls, Function definitons, and Execution model, but did not spot any text actually specifying that
Noneis returned by user-defined functions that fall off the end of their code block without encountering areturnstatement.This adds such text to the description of return values in the Calls section, which IMHO is the most likely place readers would look for it.
📚 Documentation preview 📚: https://cpython-previews--126769.org.readthedocs.build/