TRACKING: Problems in the new implementation of autodoc

[AA-Turner]

The next version of Sphinx contains a substantially rewritten (#13751) implementation of the sphinx.ext.autodoc extension.

This issue tracks regressions and missing features in the new implementation, with the view that we will eventually deprecate and remove the legacy class-based implementation.

To use the old (Sphinx 8.2 and earlier, class-based) implementation, set autodoc_use_legacy_class_based = True in your conf.py.

Please add a comment on this issue if you need to enable autodoc_use_legacy_class_based = True, ideally with a link to your project/the code that interacts with sphinx.ext.autodoc.

A

[AA-Turner]

• No way to access the builder in directives #14136
• New autodoc logic prevents necessary patches #14137
• autodoc: cannot import name 'mock' from 'sphinx.ext.autodoc'  #14142