On 7/16/2013 9:39 AM, R. David Murray wrote:
On Tue, 16 Jul 2013 23:19:21 +1000, Steven D'Aprano <st...@pearwood.info> wrote:

For example, pkgutil includes classes with single-underscore methods, which I take as 
private. It also has a function simplegeneric, which is undocumented and not listed in 
__all__. In in the absence of even a comment saying "Don't use this", I take it 
as an oversight, not policy that simplegeneric is private.

I think you'd be wrong about that, though.  simplegeneric should really be
treated as private.  I'm speaking here not about the general principle of
the thing, but about my understanding of simplegeneric's specific history.

I think Steven (valid) point is "Why not, then, say it is internal either in docs or name?"-- which in this case would be in the docs.


--
Terry Jan Reedy

_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe: 
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com

Reply via email to