https://github.com/python/cpython/commit/aa67b3fd4c846dfe9061e548428cdac3d3ada7f1 commit: aa67b3fd4c846dfe9061e548428cdac3d3ada7f1 branch: 3.15 author: Miss Islington (bot) <[email protected]> committer: hugovk <[email protected]> date: 2026-09-11T21:00:35+03:00 summary:
[3.15] gh-156837: Refer to yield expressions in generator function definitions (GH-156863) (#157220) Co-authored-by: Lucas <[email protected]> files: M Doc/reference/datamodel.rst diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst index a1f09cb13d6deb..01fa56656948bf 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]
