From: Raymond Hettinger Date: Wed, 13 May 2015 09:50:57 +0000 (-0700) Subject: Issue #19934: Document *None* as an acceptable input to Counter.most_common([n]) X-Git-Tag: v2.7.11rc1~302^2~31 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bd049190148df537e055f4975db35574448ed0b2;p=thirdparty%2FPython%2Fcpython.git Issue #19934: Document *None* as an acceptable input to Counter.most_common([n]) --- diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst index b947e272da43..2dc60e8f68bf 100644 --- a/Doc/library/collections.rst +++ b/Doc/library/collections.rst @@ -104,9 +104,9 @@ For example:: .. method:: most_common([n]) Return a list of the *n* most common elements and their counts from the - most common to the least. If *n* is not specified, :func:`most_common` - returns *all* elements in the counter. Elements with equal counts are - ordered arbitrarily: + most common to the least. If *n* is omitted or ``None` + :func:`most_common` returns *all* elements in the count + with equal counts are ordered arbitrarily: >>> Counter('abracadabra').most_common(3) [('a', 5), ('r', 2), ('b', 2)]