Overridden, overloaded class docstring return type rendered as None

[laurensvalk]

Describe the bug

Some overloaded class definitions show None as a return type, when there shouldn't be any return type.

This seems to happen when the overloaded functions are overridden in the final docstring.

A class without this problem is also provided for comparison.

How to Reproduce

Exactly the same as #10278

Expected behavior

Your project

https://github.com/pybricks/sphinx-issues-minimal

Screenshots

OS

Ubuntu

Python version

3.8.3

Sphinx version

4.4.0

Sphinx extensions

'sphinx.ext.autodoc', 'sphinx.ext.napoleon', 'sphinx_rtd_theme'

Extra tools

No response

Additional context

Related Sphinx issue: #10281

This was originally reported in pybricks/pybricks-api#87

[tk0miya]

This is not related to overloaded constructors. Autodoc automatically fills return value annotation to the signature definitions in the docstring excluding the first entry unexpectedly. So I reproduced this with this class:

class Foo:
    """Foo()
    Foo(x: int)
    Foo(x: int, y: int)

    docstring
    """

I agree this is not unexpected behavior. So I'll fix this soon.

Note: The example you given uses autoclass_content = 'both' option. Then autodoc refers the docstring of MyComplex.__init__() method too.

[laurensvalk]

9f52d7d fixes it. Thanks!