This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ncoghlan
Recipients eli.bendersky, ncoghlan, scoder, serhiy.storchaka
Date 2013-09-22.02:01:13
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <CADiSq7e6td0z07fTg10kZVY9Ow-vvtZyC4mPTM5QyM8UEq6nbA@mail.gmail.com>
In-reply-to <CAF-Rda_zWj34wnbHMOGSq92hgUoSkP=z-suYf23t5OtQq9qkxQ@mail.gmail.com>
Content
An undocumented name without a leading underscore is always a bug, as it
means introspection and the prose docs give conflicting definitions of the
public API.

Whether the fix is to remove the offending name entirely, add a leading
underscore to mark it as private or document it as officially public is a
judgement call that needs to be made on a case by case basis.
History
Date User Action Args
2013-09-22 02:01:13ncoghlansetrecipients: + ncoghlan, scoder, eli.bendersky, serhiy.storchaka
2013-09-22 02:01:13ncoghlanlinkissue18990 messages
2013-09-22 02:01:13ncoghlancreate