py:obj reference target not found

[jschueller]

sphinx 9.x has rewritten significantly its autodoc extension,
is there anything left to do in numpydoc to leverage the new api ?

I noticed the change when upgrading sphinx as I had to switch autodoc_use_legacy_class_based=True to use the legacy class-based API:
https://www.sphinx-doc.org/en/master/usage/extensions/autodoc.html#confval-autodoc_use_legacy_class_based

else it gave me lots of warnings about references not found: [ref.obj] for stuff that should be filtered by :exclude-members: (nitpicky mode), eg:

/tmp/build/python/src/site-packages/persalys/persalys.py:docstring of persalys.persalys.Analysis:8: WARNING: py:obj reference target not found: thisown [ref.obj]

that I dont get otherwise without numpydoc

so is this a known task to handle the new default, or should I try to write a minimal reproducer ?

[larsoner]

I don't know of anyone looking into this so yes some minimal reproducer would be a good start!

[jschueller]

ok, I can reproduce from the tinybuild example, when numpydoc is enabled it yields a missing ref of an excluded attribute

first install sphinx==9.0.4, numpydoc==0.20.0 then:

$ cd /tmp
$ git clone -b thisown --depth 1 https://github.com/jschueller/numpydoc.git
$ cd numpydoc/numpydoc/tests/tinybuild
$ make html
Running Sphinx v9.0.4
...
/tmp/numpydoc/numpydoc/tests/tinybuild/numpydoc_test_module.py:docstring of numpydoc_test_module.MyClass:8: WARNING: py:obj reference target not found: thisown [ref.obj]
...
build finished with problems, 1 warning (with warnings treated as errors).

now if you drop the numpydoc extension in conf.py the warning disappears
it also goes away if you keep numpydoc but uncomment the autodoc_use_legacy_class_based=True line
be sure to call make clean between atempts

or use this archive:
tinybuild.zip