On Feb 13, 2010, at 11:56 PM, David Goldsmith wrote: > > > Please don't misinterpret my statements to mean that I think this isn't > important and/or that you should feel solely responsible for a fix - I > sincerely just wanted to uncover the nature and extent of the problem. > Unfortunately, I still feel like I don't really understand the functional > origin of the problem, otherwise I'd be the first to be offering to help - > perhaps if you can explain to me what you think is happening...
In a nutshell: some functions in numpy.ma (like np.ma.compress) are actually instances of a factory class (_frommethod). This class implements a __call__ method, so its instances behave like functions. In practice, they just call a method of MaskedArray. Anyway, the __doc__ of the instance is created from the docstring of the corresponding method with _frommethod.getdoc. I'm sure that's where we can improve things (like substistute `self `by `a`. Because it's an instance, help(numpy.ma.compress) gives the docstring of numpy.ma._frommethod instead. In IPython, numpy.ma.compress? gives you the doc, twice (I don't get why). _______________________________________________ NumPy-Discussion mailing list NumPy-Discussion@scipy.org http://mail.scipy.org/mailman/listinfo/numpy-discussion