https://github.com/python/cpython/commit/2723799c7f357b6ba38a5cbbe96885a0a5fedacf
commit: 2723799c7f357b6ba38a5cbbe96885a0a5fedacf
branch: main
author: Lucas <[email protected]>
committer: encukou <[email protected]>
date: 2026-09-09T16:33:53+02:00
summary:
gh-156837: Refer to yield expressions in generator function definitions
(GH-156863)
files:
M Doc/reference/datamodel.rst
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index fde3cef63bc6e90..00a80010543be17 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -798,12 +798,12 @@ Generator functions
single: generator; function
single: generator; iterator
-A function or method which uses the :keyword:`yield` statement (see section
-:ref:`yield`) is called a :dfn:`generator function`. Such a function, when
+A function or method which contains a :keyword:`yield` expression (see section
+:ref:`yieldexpr`) is called a :dfn:`generator function`. Such a function, when
called, always returns an :term:`iterator` object which can be used to
execute the body of the function: calling the iterator's
:meth:`iterator.__next__` method will cause the function to execute until
-it provides a value using the :keyword:`!yield` statement. When the
+it provides a value using the :keyword:`!yield` expression. When the
function executes a :keyword:`return` statement or falls off the end, a
:exc:`StopIteration` exception is raised and the iterator will have
reached the end of the set of values to be returned.
@@ -830,7 +830,7 @@ Asynchronous generator functions
single: asynchronous generator; asynchronous iterator
A function or method which is defined using :keyword:`async def` and
-which uses the :keyword:`yield` statement is called a
+which contains a :keyword:`yield` expression is called a
:dfn:`asynchronous generator function`. Such a function, when called,
returns an :term:`asynchronous iterator` object which can be used in an
:keyword:`async for` statement to execute the body of the function.
_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]
