[3.12] Document that return-less user-defined functions return None (GH-126769) (#126823)

miss-islington · jmarshall · asvetlov · web-flow · commit d79acd96e083 · 2024-11-14T10:46:26.000+01:00
Document that return-less user-defined functions return None (GH-126769) (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
@@ -1149,7 +1149,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::
