[ python-Bugs-856072 ] UserDict.DictMixin's comments should be a docstring

[SourceForge.net]

Bugs item #856072, was opened at 2003-12-08 17:19
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=856072&group_id=5470

Category: Python Library
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Andrew Bennetts (spiv)
Assigned to: Nobody/Anonymous (nobody)
Summary: UserDict.DictMixin's comments should be a docstring

Initial Comment:
DictMixin in the UserDict module has no docstring --
but it has a comment that reads like one.  I think the
comment should probably be changed to a docstring so
that interactive use of e.g. "help(UserDict.DictMixin)"
explains how it works (override _getitem__(),
__setitem__(), __delitem__(), and keys(), and the rest
is done for you).

If the existing comment is considered too cryptic, the
text in the Library Reference for DictMixin would be a
good basis for a docstring.

(This is a really minor bug, but it's a shame to see
such a useful class not being perfectly documented! :)

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=856072&group_id=5470