Toplevel "test()" functions in standard library

[Rob W. W. Hooft]

>>>>> "MZ" == Moshe Zadka <moshez at math.huji.ac.il> writes:

 >> I will subtract my proposal, and submit a bug report that those
 >> test() routines are undocumented.

 MZ> Why? It's quite alright that there will be undocumented routines
 MZ> in modules. This is a module implementation issue. (If you want
 MZ> to test that the module is working, you can look inside)

I agree that there can be internal routines in a module. But:

 - python has a nice way of hiding those routines from the casual user
   of the library, namely adding an '_' before the name.

 - you already argued that base64.test() provided useful functionality.
   Why not document it?

Rob

-- 
=====   rob at hooft.net          http://www.hooft.net/people/rob/  =====
=====   R&D, Nonius BV, Delft  http://www.nonius.nl/             =====
===== PGPid 0xFA19277D ========================== Use Linux! =========