[docs] [issue18326] Mention 'keyword only' for list.sort, improve glossary.

Zachary Ware report at bugs.python.org
Fri Jul 5 21:58:46 CEST 2013

Zachary Ware added the comment:

How about this patch?

I agree that "types of arguments/parameters" has great potential for confusion, so the glossary has been changed to "kinds of argument/parameter" (dropping the pluralization as well; it is unnecessary).  I think just taking the word "type" out of it makes the rest of each entry unambiguous.

To list.sort, I simply added a line: ":meth:`sort` accepts two arguments which can only be passed by keyword:".  I considered making each parameter's description an indented block after that, but that seems like more change than is really necessary, and the patched version doesn't look too bad to me.

keywords: +patch
nosy: +zach.ware
Added file: http://bugs.python.org/file30781/issue18326.diff

Python tracker <report at bugs.python.org>

More information about the docs mailing list