mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 10:19:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 8

Issue #18326: Clarify that list.sort's arguments are keyword-only.

Browse source 
Also, attempt to reduce confusion in the glossary by not saying there are
different "types" of arguments and parameters.
This commit is contained in:
Zachary Ware 2013-11-22 13:58:34 -06:00
parent 0b1386d922
commit e1391a0d68
3 changed files with 14 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

3
Doc/library/stdtypes.rst
View file

@ -1149,6 +1149,9 @@ application).
fail, the entire sort operation will fail (and the list will likely be left
in a partially modified state).
:meth:`sort` accepts two arguments that can only be passed by keyword
(:ref:`keyword-only arguments <keyword-only_parameter>`):
*key* specifies a function of one argument that is used to extract a
comparison key from each list element (for example, ``key=str.lower``).
The key corresponding to each item in the list is calculated once and