From: Łukasz Rogalski <rogalski.91@gmail.com>
Date: Fri, 14 Jul 2017 19:57:19 +0000 (+0200)
Subject: Doc that 'sorted' args are keyword-only, fix 'reverse' default (#2709)
X-Git-Tag: v3.6.3rc1~234
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ea9cbe0a5cc4d35643939c6ddee7fc96dbfff211;p=python

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 6621f4aabf..916e3528d7 100644
--- 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 5ab8177490..e929f0b687 100644
--- 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