python
diff --git a/‎Doc/library/functions.rst
Copy file name to clipboardExpand all lines: Doc/library/functions.rst
+23Lines changed: 23 additions & 0 deletions b/‎Doc/library/functions.rst
Copy file name to clipboardExpand all lines: Doc/library/functions.rst
+23Lines changed: 23 additions & 0 deletions
diff --git a/‎Misc/NEWS.d/next/Core and Builtins/2023-12-20-08-54-54.gh-issue-113212.62AUlw.rst
Copy file name to clipboard
+2Lines changed: 2 additions & 0 deletions b/‎Misc/NEWS.d/next/Core and Builtins/2023-12-20-08-54-54.gh-issue-113212.62AUlw.rst
Copy file name to clipboard
+2Lines changed: 2 additions & 0 deletions
@@ -1845,6 +1845,29 @@ are always available.  They are listed here in alphabetical order.
    :func:`super`, see `guide to using super()
    <https://rhettinger.wordpress.com/2011/05/26/super-considered-super/>`_.
 
+   .. note::
+      By default, if no second argument is provided, :func:`super` uses the first argument
+      of the immediately enclosing function definition, which is ``self`` under normal circumstances.
+      This may lead to unexpected behaviour if used inside nested functions or generator expressions
+      (the latter creates implicit nested functions). The following example will result in an exception::
+
+         class A:
+            def method(self):
+               return 1
+
+         class B(A):
+            def method(self):
+               return list(super().method() for _ in range(3))   # Expected [1, 1, 1] but TypeError will be raised.
+
+      In such cases, you should provide arguments explicitly::
+
+         class A:
+            def method(self):
+               return 1
+
+         class B(A):
+            def method(self):
+               return list(super(B, self).method() for _ in range(3))   # Will return [1, 1, 1].
 
 .. _func-tuple:
 .. class:: tuple()
 
@@ -0,0 +1,2 @@
+improve :py:class:`super` error message && document zero-arg :py:class:`super` inside nested
+functions and generator expressions
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	+improve :py:class:`super` error message && document zero-arg :py:class:`super` inside nested
	`2`	`+functions and generator expressions`