Document that return-less user-defined functions return None (pythonGH-126769)

jmarshall · asvetlov · willingc · miss-islington · commit 62a3f72bd02b · 2024-11-14T07:47:32.000Z
(cherry picked from commit e0692f1) Co-authored-by: John Marshall <jmarshall@hey.com> Co-authored-by: Andrew Svetlov <andrew.svetlov@gmail.com> Co-authored-by: Carol Willing <carolcode@willingconsulting.com>
diff --git a/Doc/reference/expressions.rst b/Doc/reference/expressions.rst
@@ -1156,7 +1156,8 @@ a user-defined function:
    first thing the code block will do is bind the formal parameters to the
    arguments; this is described in section :ref:`function`.  When the code block
    executes a :keyword:`return` statement, this specifies the return value of the
-   function call.
+   function call.  If execution reaches the end of the code block without
+   executing a :keyword:`return` statement, the return value is ``None``.
 
 a built-in function or method:
    .. index::
