[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Changes by Berker Peksag : -- stage: needs patch -> resolved ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: htt

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Changes by Raymond Hettinger : -- resolution: -> rejected status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing l

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Raymond Hettinger added the comment: http://svn.python.org/view/python/branches/release25-maint/Doc/lib/libcollections.tex?r1=38658&r2=42573 -- ___ Python tracker ___

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Raymond Hettinger added the comment: [John Posner] > The fact is that a programmer using defaultdict does not need > to know anything about __missing__. I disagree. It seems to help people understand the defaultdict which otherwise seems more magical that it actually is. Also, it is a part o

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Terry J. Reedy added the comment: I agree that the patch is not acceptable as is. The public attribute *defaultdict* should be explicitly documented as it is now, so that it is indexed. On the other hand, users should not directly call .__missing__, and it is not normal to document the priva

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Changes by Ethan Furman : -- nosy: +ethan.furman ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.py

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Changes by Ezio Melotti : -- nosy: +ezio.melotti status: pending -> open ___ Python tracker ___ ___ Python-bugs-list mailing list Unsub

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

Changes by John Posner : -- status: open -> pending ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

John Posner added the comment: On python-list, Wolfram Hinderer objected to the proposed patch's calling __missing__ a "special method". -- ___ Python tracker ___ __

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

John Posner added the comment: I think it would be confusing to create of subclass of defaultdict, defining a __missing__ method in that subclass. The existence of the __missing__ method would cancel the main functionality of the defaultdict object: invoking the "default value factory" callab

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

R. David Murray added the comment: I believe the description of __missing__ is there for those who want to subclass defaultdict, but I'll let Raymond confirm. -- nosy: +r.david.murray, rhettinger resolution: -> invalid stage: -> committed/rejected status: open -> pending type: -> be

[issue9536] defaultdict doc makes incorrect reference to __missing__ method

New submission from John Posner : The documentation for collections.defaultdict is confusing with respect to the __missing__ method. The fact is that a programmer using defaultdict does not need to know anything about __missing__. The attached patch contains a rewrite of the entire section (bu