Message198241
| 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. |
|