Doc that 'sorted' args are keyword-only, fix 'reverse' default (#2709)

backport

diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 6621f4aabf705877ff20b655fe9b7c81509249d0..916e3528d79dac00371c1c549b43641fa71b89ec 100644 (file)
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1319,7 +1319,7 @@ are always available.  They are listed here in alphabetical order.
    :func:`itertools.islice` for an alternate version that returns an iterator.
 
 
-.. function:: sorted(iterable[, key][, reverse])
+.. function:: sorted(iterable, *, key=None, reverse=False)
 
    Return a new sorted list from the items in *iterable*.
 

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 5ab8177490d6ce2e56408f00477897f58942e4c2..e929f0b68767d47a80487f8532689ad024db597c 100644 (file)
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1161,7 +1161,7 @@ application).
    :ref:`mutable <typesseq-mutable>` sequence operations. Lists also provide the
    following additional method:
 
-   .. method:: list.sort(*, key=None, reverse=None)
+   .. method:: list.sort(*, key=None, reverse=False)
 
       This method sorts the list in place, using only ``<`` comparisons
       between items. Exceptions are not suppressed - if any comparison operations