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

Fergal Daly report at bugs.python.org
Mon Nov 8 23:38:41 CET 2010

Fergal Daly <fergald at gmail.com> 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 string is explicit about what it requires from the argument:

 |  update(...)
 |      D.update(E, **F) -> None.  Update D from dict/iterable E and F.
 |      If E has a .keys() method, does:     for k in E: D[k] = E[k]
 |      If E lacks .keys() method, does:     for (k, v) in E: D[k] = v
 |      In either case, this is followed by: for k in F: D[k] = F[k]


Python tracker <report at bugs.python.org>

More information about the Python-bugs-list mailing list