[issue2172] Add doc-string to UserDict and DictMixin

Alexander Belopolsky <[EMAIL PROTECTED]> added the comment: On Mon, Mar 24, 2008 at 4:53 AM, Raymond Hettinger <[EMAIL PROTECTED]> wrote: > I'm not sure the class docstring approach is suitable for a mixin. It > seems fine to me that pydoc strips the commentary on the mixin as a > standalone

[issue2172] Add doc-string to UserDict and DictMixin

Raymond Hettinger <[EMAIL PROTECTED]> added the comment: I'm not sure the class docstring approach is suitable for a mixin. It seems fine to me that pydoc strips the commentary on the mixin as a standalone class; instead it appropriately focuses on the client class that uses the mixin as part

[issue2172] Add doc-string to UserDict and DictMixin

Changes by Raymond Hettinger: -- assignee: -> rhettinger nosy: +rhettinger __ Tracker <[EMAIL PROTECTED]> __ ___ Python-bugs-list mailing list

[issue2172] Add doc-string to UserDict and DictMixin

Changes by Alexander Belopolsky: -- components: +Documentation versions: +Python 2.6 __ Tracker <[EMAIL PROTECTED]> __ ___ Python-bugs-list mail

[issue2172] Add doc-string to UserDict and DictMixin

Alexander Belopolsky added the comment: Fixed an error in lavels doc. Needs review. __ Tracker <[EMAIL PROTECTED]> __ ___ Python-bugs-list mailing list

[issue2172] Add doc-string to UserDict and DictMixin

Changes by Alexander Belopolsky: Added file: http://bugs.python.org/file9530/UserDict-doc.diff __ Tracker <[EMAIL PROTECTED]> __ ___ Python-bugs-list ma

[issue2172] Add doc-string to UserDict and DictMixin

New submission from Alexander Belopolsky: Attached patch improves pydoc UserDict presentation. One of the problems with the current documentation in comments is that order of methods is not preserved and thus the method level comments in DictMixin implementation are meaningless in pydoc. (In a