[3.14] gh-133881: add forward reference to list.sort() in lambda expression tutorial (GH-133910) (#134126)

miss-islington · Shepard2154 · web-flow · commit 075cabb02650 · 2025-05-17T08:05:47.000Z
gh-133881: add forward reference to `list.sort()` in lambda expression tutorial (GH-133910) (cherry picked from commit c1c9ad1) Co-authored-by: Oleg Burnaev <51371645+Shepard2154@users.noreply.github.com>
diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
@@ -999,7 +999,8 @@ scope::
    43
 
 The above example uses a lambda expression to return a function.  Another use
-is to pass a small function as an argument::
+is to pass a small function as an argument.  For instance, :meth:`list.sort`
+takes a sorting key function *key* which can be a lambda function::
 
    >>> pairs = [(1, 'one'), (2, 'two'), (3, 'three'), (4, 'four')]
    >>> pairs.sort(key=lambda pair: pair[1])

Original file line number	Diff line number	Diff line change
`@@ -999,7 +999,8 @@ scope::`
`999`	`999`	`43`
`1000`	`1000`
`1001`	`1001`	`The above example uses a lambda expression to return a function. Another use`
`1002`		`-is to pass a small function as an argument::`
	`1002`	+is to pass a small function as an argument. For instance, :meth:`list.sort`
	`1003`	`+takes a sorting key function key which can be a lambda function::`
`1003`	`1004`
`1004`	`1005`	`>>> pairs = [(1, 'one'), (2, 'two'), (3, 'three'), (4, 'four')]`
`1005`	`1006`	`>>> pairs.sort(key=lambda pair: pair[1])`