On Thu, Jul 31, 2008 at 04:42, Stéfan van der Walt <[EMAIL PROTECTED]> wrote:
> 2008/7/31 Andrew Dalke <[EMAIL PROTECTED]>:
>> I wrote that I don't know the reasons for why the design was as it
>> is. Are those functions ("english_upper", "english_lower",
>> "english_capitalize") expected as part of the public interface for
>> the module? The lack of a "_" prefix and their verbose docstrings
>> implies that they are for general use. In that case, they can't
>> easily be gotten rid of. Yet it doesn't make sense for them to be
>> part of 'numerictypes'.
>
> Anything underneath numpy.core that is not exposed as numpy.something
> is not for public consumption.
That said, the reason those particular docstrings are verbose is
because I wanted people to know why those functions exist there (e.g.
"This is an internal utility function....").
But you still can't remove them since they are being used inside
numerictypes. That's why I labeled them "internal utility functions"
instead of leaving them with minimal docstrings such that you would
have to guess.
--
Robert Kern
"I have come to believe that the whole world is an enigma, a harmless
enigma that is made terrible by our own mad attempt to interpret it as
though it had an underlying truth."
-- Umberto Eco
_______________________________________________
Numpy-discussion mailing list
Numpy-discussion@scipy.org
http://projects.scipy.org/mailman/listinfo/numpy-discussion
