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

[Zachary Ware]

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>
<http://bugs.python.org/issue18326>
_______________________________________