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 a.badger
Recipients a.badger, georg.brandl
Date 2011-01-05.23:46:55
SpamBayes Score 7.5984374e-10
Marked as misclassified No
Message-id <1294271235.41.0.546549393078.issue10838@psf.upfronthosting.co.za>
In-reply-to
Content
For other's reference, there were three threads in November2010 that touch on this:

  :About removing argparse.__all__ or adding more methods to it:
    http://mail.python.org/pipermail/python-dev/2010-November/105147.html

  :Removing tk interface in pydoc:
    http://mail.python.org/pipermail/python-dev/2010-November/105375.html

The most on topic thread is the one with Subject:
  :[Python-Dev] Breaking undocumented API:
    http://mail.python.org/pipermail/python-dev/2010-November/105392.html

People broke threading a few times so you might have to search on the subject.

And ick.  The thread's more of a mess than I remembered.  Reading what Guido wrote last it seems like:

All private names should be prepended with "_" .  Imported modules are the exception to this -- they're private unless included in __all__.  Reading between the lines I think it's also saying that not all public names need to be in __all__.

So to resolve this ticket:

1) Is this the actual consensus from the end of those threads?
2) Are the three names mentioned in this ticket public or private?
3a) If private, initiate deprecation and create underscore versions of the variables.
3b) If public, documentation and adding to __all__ are good but not necessary.
History
Date User Action Args
2011-01-05 23:47:15a.badgersetrecipients: + a.badger, georg.brandl
2011-01-05 23:47:15a.badgersetmessageid: <1294271235.41.0.546549393078.issue10838@psf.upfronthosting.co.za>
2011-01-05 23:46:55a.badgerlinkissue10838 messages
2011-01-05 23:46:55a.badgercreate