[Numpy-discussion] Why are ufunc docstrings useless?

[Anne Archibald]

Hi,

I frequently use functions like np.add.reduce and np.add.outer, but
their docstrings are totally uninformative. Would it be possible to
provide proper docstrings for these ufunc methods? They need not be
specific to np.add; just an explanation of what arguments to give (for
example) reduce() (presumably it takes an axis= argument? what is the
default behaviour?) and what it does would help.

Thanks,
Anne