builtins docs

Author: dg-pb

Doc/library/functions.rst

@@ -1840,7 +1840,7 @@ are always available.  They are listed here in alphabetical order.
       Slice objects are now :term:`hashable` (provided :attr:`~slice.start`,
       :attr:`~slice.stop`, and :attr:`~slice.step` are hashable).
 
-.. function:: sorted(iterable, /, *, key=None, reverse=False)
+.. function:: sorted(iterable, /, *, key=None, keylist=None, reverse=False)
 
    Return a new sorted list from the items in *iterable*.
 
@@ -1850,6 +1850,10 @@ are always available.  They are listed here in alphabetical order.
    key from each element in *iterable* (for example, ``key=str.lower``).  The
    default value is ``None`` (compare the elements directly).
 
+   Alternative to key function is supplying a :class:`list` object
+   to *keylist* argument, which will determine the sort order.
+   Provided :class:`list` object will be modified in place.
+
    *reverse* is a boolean value.  If set to ``True``, then the list elements are
    sorted as if each comparison were reversed.
 
@@ -1872,6 +1876,11 @@ are always available.  They are listed here in alphabetical order.
 
    For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`.
 
+   .. versionchanged:: 3.15
+
+      Added *keylist* argument.
+
+
 .. decorator:: staticmethod
 
    Transform a method into a static method.

Doc/library/stdtypes.rst

@@ -1414,8 +1414,9 @@ application).
       The :func:`functools.cmp_to_key` utility is available to convert a 2.x
       style *cmp* function to a *key* function.
 
-      Alternative to key function is supplying a list to *keylist* argument,
-      which will determine sort order and will be modified in place.
+      Alternative to key function is supplying a :class:`list` object
+      to *keylist* argument, which will determine the sort order.
+      Provided :class:`list` object will be modified in place.
 
       *reverse* is a boolean value.  If set to ``True``, then the list elements
       are sorted as if each comparison were reversed.