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 <rep...@bugs.python.org> <http://bugs.python.org/issue18326> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
