Roundup Robot added the comment:
New changeset 9192c0798a90 by Zachary Ware in branch '3.3':
Issue #18326: Clarify that list.sort's arguments are keyword-only.
http://hg.python.org/cpython/rev/9192c0798a90
New changeset 3f1c332c5e2e by Zachary Ware in branch 'default':
Issue #18326: merge with
Changes by Zachary Ware zachary.w...@gmail.com:
--
assignee: docs@python - zach.ware
resolution: - fixed
stage: patch review - committed/rejected
status: open - closed
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue18326
Ezio Melotti added the comment:
I think v2 is enough, but v3 is fine with me if people think v3 it's better.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue18326
___
Zachary Ware added the comment:
Any further thoughts on this? I think my vote is for v3, except s/must/can
only/. must makes it sound like you are forced to pass those arguments.
--
___
Python tracker rep...@bugs.python.org
Zachary Ware added the comment:
How about a combination of the two? It's still short, but gets the point
across without assuming the reader knows exactly what 'keyword-only argument'
or requiring further reading, while introducing the term and providing the link
for deeper understanding.
R. David Murray added the comment:
In this expository context, I prefer the issue18326.that.diff version, but the
index link to the keyword-only_parameter ref should still be added to it (on
only be passed by keyword).
--
___
Python tracker
Zachary Ware added the comment:
How about this?
--
Added file: http://bugs.python.org/file31385/issue18326.v2.diff
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue18326
___
Ezio Melotti added the comment:
keyword-only is a well-established term, and I think it's better to use it
and possibly make it a link to the parameter entry of the glossary.
--
nosy: +ezio.melotti
stage: needs patch - patch review
___
Python
Terry J. Reedy added the comment:
'keyword argument' refers one to 'argument'. The entry for the latter says that
there are only two types of arguments, keyword and positional. That is true as
to how actual arguments are passed.
There are 3 possibilities for how a single argument for a
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
Terry J. Reedy added the comment:
The new 'which' should be 'that'. Other than that, looks good to me.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue18326
___
Changes by Zachary Ware zachary.w...@gmail.com:
Added file: http://bugs.python.org/file30785/issue18326.that.diff
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue18326
___
12 matches
Mail list logo