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

jmarshall · asvetlov · willingc · web-flow · commit e0692f11650a · 2024-11-14T07:47:24.000Z
Co-authored-by: Andrew Svetlov &lt;andrew.svetlov@gmail.com&gt;
Co-authored-by: Carol Willing &lt;carolcode@willingconsulting.com&gt;
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::
