doc/changes/9.0.rst
!sphinx.ext.autodoc.
Patch by Adam Turner.!sphinx.ext.autodoc.mock.
Patch by Adam Turner.#13786: Support Docutils 0.22_. Patch by Adam Turner.
.. _Docutils 0.22: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-22-2026-07-29
!SphinxComponentRegistry.create_source_parser no longer
has an app parameter, instead taking config and env.
Patch by Adam Turner.sphinx.ext.autodoc has been substantially rewritten,
and there may be some incompatible changes in edge cases, especially when
extensions interact with autodoc internals.
The :confval:autodoc_use_legacy_class_based option has been added to
use the legacy (pre-9.0) implementation of autodoc.
Patches by Adam Turner.!.app attributes,
including builder.app, env.app, events.app,
and SphinxTransform.app.
Patch by Adam Turner.!set_application method
of :py:class:~sphinx.parsers.Parser objects.
Patch by Adam Turner.!Parser.config and :py:attr:!env attributes.
Patch by Adam Turner.!sphinx.io.
Sphinx no longer uses the :py:mod:!sphinx.io classes,
having replaced them with standard Python I/O.
The entire :py:mod:!sphinx.io module will be removed in Sphinx 10.
Patch by Adam Turner.!sphinx.environment.adapters.toctree.global_toctree_for_doc
and :meth:!sphinx.environment.BuildEnvironment.get_and_resolve_doctree
will require a tags keyword argument from Sphinx 11.
It may optionally be passed from Sphinx 9 onwards.
Patch by Adam Turner.doctest_fail_fast option to exit after the first failed
test.
Patch by Till Hoffmann.linkcheck_allowed_redirects = {}.
Patch by Adam Turner and James Addison.fontawesome6 package.
Patch by Jean-François B.typing_extensions.overload <typing.overload>
and :py:func:~typing.final decorators.
Patch by Spencer Brown.fontawesome7 package.
Patch by Jean-François B.695 type aliases.
Patch by Martin Matouš, Jeremy Maitin-Shepard, and Adam Turner.mathjax_config_path option
to load MathJax configuration from a file.
Patch by Randolf Scholz and Adam Turner.linkcheck_case_insensitive_urls option
to allow case-insensitive URL comparison for specific URL patterns.
This is useful for links to websites that normalise URL casing (e.g. GitHub)
or case-insensitive servers.
Patch by Fazeel Usmani and James Addison.sphinx.ext.duration.
Patch by Erik Bedard and Adam Turner.sphinx.ext.mathjax extension,
from v3 previously.
To keep using an older version, set the :confval:mathjax_path option.
Also add the new :confval:mathjax4_config option to configure MathJax v4.
Note that MathJax v3 is mostly compatible with MathJax v4, so existing
:confval:mathjax3_config settings should not need to change.
Patch by Matthias Geier.source_code_parser type to :confval:suppress_warnings
for grouping issues related to the C and C++ parsers.
Patch by Valentin H.tabularcolumns specifies automatic widths
(L, R, C, or J).
Patch by Jean-François B.~ prefix support for :rst:role:py:deco.
Patch by Shengyu Zhang and Adam Turner.latex_show_urls = 'footnote').
Patch by Jean-François B.<em class="property"> with
<span class="property"> for attribute type annotations
to improve semantic HTML structure <https://html.spec.whatwg.org/multipage/text-level-semantics.html>__.
Patch by Mark Ostroth.confval value does not wrap at
spaces in PDF.
Patch by Jean-François B.:py:data: to be hyperlinked in function signatures.doctest_test_doctest_blocks.ref.equation.
Patch by Jared Dillard.autodoc_type_aliases when they appear in PEP 604
union syntax (Alias | Type).
Patch by Tamika Nomara.babel-french).
Patch by Jean-François B.Some type variables (...) are not listed in Generic[...]
TypeError when inheriting from both Generic and autodoc mocked class.
Patch by Ikor Jefocur and Daniel Sperber.FORWARDREF :mod:annotationlib format.
Patch by Rui Pinheiro and Adam Turner.js:function arguments and errors.
Patch by Shengyu Zhang.