[Numpy-discussion] Why are ufunc docstrings useless?

[Anne Archibald]

2008/5/8 Robert Kern <robert.kern at gmail.com>:
> On Thu, May 8, 2008 at 9:52 PM, Anne Archibald
> <peridot.faceted at gmail.com> wrote:
>
>> Thanks! Done add, reduce, outer, and reduceat. What about __call__?
>
> If anyone knows enough to explicitly request a docstring from
> __call__, they already know what it does.

How exactly are they to find out? It does take additional arguments,
for example dtype and out - I think.

Also, help(np.add) displays the the object, its docstring, its
methods, and all their docstrings. So it provides a way to get a
docstring out of __call__ without having to know what it is.

Anne