Note that the key and reverse arguments must be specified as keywords

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index df3e16ce1d53e43ec55359a230ccb4f37cd36b0a..18e827015a4805958a3878e815a0844b6d02ea50 100644 (file)
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -979,9 +979,7 @@ available.  They are listed here in alphabetical order.
 
    Return a new sorted list from the items in *iterable*.
 
-   The optional arguments *key* and *reverse* have the same meaning as
-   those for the :meth:`list.sort` method (described in section
-   :ref:`typesseq-mutable`).
+   Has two optional arguments which must be specified as keyword arguments.
 
    *key* specifies a function of one argument that is used to extract a comparison
    key from each list element: ``key=str.lower``.  The default value is ``None``.