From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 17 May 2025 08:05:41 +0000 (+0200)
Subject: [3.13] gh-133881: add forward reference to `list.sort()` in lambda expression tutoria... 
X-Git-Tag: v3.13.4~101
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c5298705427184b0fa78d8fdee3ffba5d1bb7f73;p=thirdparty%2FPython%2Fcpython.git

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

gh-133881: add forward reference to `list.sort()` in lambda expression tutorial (GH-133910)
(cherry picked from commit c1c9ad1d5a62a591eb2f0f0d29f3fa02e0949f14)

Co-authored-by: Oleg Burnaev <51371645+Shepard2154@users.noreply.github.com>
---

diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst
index 8261bbdbfb7a..b8bc94e52180 100644
--- a/Doc/tutorial/controlflow.rst
+++ b/Doc/tutorial/controlflow.rst
@@ -998,7 +998,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])