On Fri, 29 Jul 2011 11:51:18 -0400
Barry Warsaw <ba...@python.org> wrote:
> On Jul 29, 2011, at 05:25 PM, Antoine Pitrou wrote:
> 
> >> test.support *is* part of the stdlib.
> >
> >We have lots of internal APIs which are not documented, though.
> >And test.support *is* for internal use.
> 
> The solution then is to rename test.support to test._support to make it clear
> it's an internal implementation detail.  Then you can remove the entire
> section from the stdlib docs and just document it in the code.

Ideally so. Practically, it's a lot of churn and additional pain
merging 3.2 bugfixes into default. The lack of an underscore doesn't
always mean the API is public, because it hasn't always worked like
this (we have many private APIs without an underscore).

Regards

Antoine.


_______________________________________________
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