ndarray.copy docstring missing Returns section

[lxop]

As the title says. This interferes with tools that infer types from the docstring, e.g. PyCharm.

Just requires the addition of

    Returns
    -------
    arr : ndarray
        Copy of the array `a`.
    

Reproducing code example:

import numpy as np
help(np.ndarray.copy)

Numpy/Python version information:

1.15.2 3.7.0 (default, Sep 12 2018, 18:30:08) 
[GCC 8.0.1 20180414 (experimental) [trunk revision 259383]]

[johannfaouzi]

Looking at the source code:

numpy/numpy/core/_add_newdocs.py

Lines 2806 to 2861 in 982f12b

	add_newdoc('numpy.core.multiarray', 'ndarray', ('conjugate',
	"""
	a.conjugate()
	Return the complex conjugate, element-wise.
	Refer to `numpy.conjugate` for full documentation.
	See Also
	--------
	numpy.conjugate : equivalent function
	"""))
	add_newdoc('numpy.core.multiarray', 'ndarray', ('copy',
	"""
	a.copy(order='C')
	Return a copy of the array.
	Parameters
	----------
	order : {'C', 'F', 'A', 'K'}, optional
	Controls the memory layout of the copy. 'C' means C-order,
	'F' means F-order, 'A' means 'F' if `a` is Fortran contiguous,
	'C' otherwise. 'K' means match the layout of `a` as closely
	as possible. (Note that this function and :func:`numpy.copy` are very
	similar, but have different default values for their order=
	arguments.)
	See also
	--------
	numpy.copy
	numpy.copyto
	Examples
	--------
	>>> x = np.array([[1,2,3],[4,5,6]], order='F')
	>>> y = x.copy()
	>>> x.fill(0)
	>>> x
	array([[0, 0, 0],
	[0, 0, 0]])
	>>> y
	array([[1, 2, 3],
	[4, 5, 6]])
	>>> y.flags['C_CONTIGUOUS']
	True
	"""))

it looks like that it is the case for all the methods. I would assume that it is voluntary rather than a bug (all the methods of numpy.ndarray that I have in mind return a numpy.ndarray), but it is just my guess.

[mattip]

There is also an experimental repo of type annotations https://github.com/numpy/numpy-stubs