Message192351
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. |
|
Date |
User |
Action |
Args |
2013-07-05 19:58:46 | zach.ware | set | recipients:
+ zach.ware, terry.reedy, r.david.murray, docs@python, icedream91 |
2013-07-05 19:58:46 | zach.ware | set | messageid: <1373054326.28.0.629456302269.issue18326@psf.upfronthosting.co.za> |
2013-07-05 19:58:46 | zach.ware | link | issue18326 messages |
2013-07-05 19:58:46 | zach.ware | create | |
|