[issue10357] ** and "mapping" are poorly defined in python docs

New submission from Fergal Daly : According to the index, the only place that mentions ** in argument lists is http://docs.python.org/tutorial/controlflow.html#index-1099 and gives no indication of what an object must support to allow **. When you attempt to ** an object the real attribute exc

[issue10357] ** and "mapping" are poorly defined in python docs

Changes by Giampaolo Rodola' : -- nosy: +giampaolo.rodola ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http:

[issue10357] ** and "mapping" are poorly defined in python docs

R. David Murray added the comment: I think the Glossary entry needs to be updated to point to the authoritative source for 'mapping' methods: http://docs.python.org/library/collections.html#abcs-abstract-base-classes (and yes, I realize that info is not located in a particularly intuitive lo

[issue10357] ** and "mapping" are poorly defined in python docs

Changes by Raymond Hettinger : -- assignee: d...@python -> rhettinger ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubsc

[issue10357] ** and "mapping" are poorly defined in python docs

Fergal Daly added the comment: Even if the glossary pointed to collections.html, there are far more methods specified there than are needed to be **able. The code just calls into the same code as dict.update(dict) (although .update can also work on a sequence of twouples). dict.update's doc s

[issue10357] ** and "mapping" are poorly defined in python docs

Raymond Hettinger added the comment: > Even if the glossary pointed to collections.html, > there are far more methods specified there than > are needed to be **able. That is an implementation detail and is subject to change. If someone supplies an argument satisfying collections.Mapping, tha

[issue10357] ** and "mapping" are poorly defined in python docs

Raymond Hettinger added the comment: Clarified what it means to be a mapping in r87871 and r87872. -- resolution: -> fixed status: open -> closed ___ Python tracker ___ ___