sphinx-9.0.4 (Wait a week for package to settle) (Python module)

[Bruce Dubbs]

New major version.

[Bruce Dubbs]

Release 9.0.0 (released Nov 30, 2025)

Dependencies

• 13786: Support Docutils 0.22.

Incompatible changes

• 13639: :py:meth:`!SphinxComponentRegistry.create_source_parser` no longer has an *app* parameter, instead taking *config* and *env*.
• 13679: Non-decodable characters in source files now raise an error. Such bytes have been replaced with '?' along with logging a warning since Sphinx 2.0.
• 13751, 14089: :mod: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.
• 13355: Don't include escaped title content in the search index.

Deprecated

• 13627: Deprecate remaining public :py:attr:`!.app` attributes, including builder.app, env.app, events.app, and SphinxTransform.app.
• 13637: Deprecate the :py:meth:`!set_application` method of :py:class:`~sphinx.parsers.Parser` objects.
• 13644: Deprecate the :py:attr:`!Parser.config and :py:attr:!env` attributes.
• 13665: Deprecate support for non-UTF 8 source encodings, scheduled for removal in Sphinx 10.
• 13682: Deprecate :py:mod:`!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.
• 13631: :func:!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.

Features added

• 13332: Add :confval:doctest_fail_fast option to exit after the first failed test.
• 13439: linkcheck: Permit warning on every redirect with linkcheck_allowed_redirects = {}.
• 13497: Support C domain objects in the table of contents.
• 13500: LaTeX: add support for fontawesome6 package.
• 13509: autodoc: Detect :py:func:`typing_extensions.overload <typing.overload>` and :py:func:`~typing.final` decorators.
• 13535: html search: Update to the latest version of Snowball (v3.0.1).
• 13647: LaTeX: allow more cases of table nesting.
• 13657: LaTeX: support CSS3 length units.
• 13684: intersphinx: Add a file-based cache for remote inventories. The location of the cache directory must not be relied upon externally, as it may change without notice or warning in future releases.
• 13805: LaTeX: add support for fontawesome7 package.
• 13508: autodoc: Initial support for :pep:695 type aliases.
• 14023: Add the new :confval:mathjax_config_path option to load MathJax configuration from a file.
• 14046: linkcheck: Add the :confval: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.
• 14075: autosummary: Provide more context in import exception stack traces.
• 13468: Add config options to :mod:sphinx.ext.duration.
• 14022: Use MathJax v4 by default in the :mod: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.
• 14029: intersphinx: Fix error in format string interpolation.
• 13894: Add source_code_parser type to :confval:suppress_warnings for grouping issues related to the C and C++ parsers.

Bugs fixed

• 13926: multiple py:type directives for the same canonical type no longer result in spurious duplicate object description warnings.
• 1327: LaTeX: tables using longtable raise error if :rst:dir:`tabularcolumns` specifies automatic widths (L, R, C, or J).
• 3447: LaTeX: when assigning longtable class to table for PDF, it may render "horizontally" and overflow in right margin.
• 8828: LaTeX: adding a footnote to a longtable cell causes table to occupy full width.
• 11498: LaTeX: Table in cell fails to build if it has many rows.
• 11515: LaTeX: longtable does not allow nested table.
• 11973: LaTeX: links in table captions do not work in PDF.
• 12821: LaTeX: URLs/links in section titles should render in PDF.
• 13369: Correctly parse and cross-reference unpacked type annotations.
• 13528: Add tilde ~ prefix support for :rst:role:`py:deco`.
• 13597: LaTeX: table nested in a merged cell leads to invalid LaTeX mark-up and PDF cannot be built.
• 13619: LaTeX: possible duplicated footnotes in PDF from object signatures (typically if :confval:latex_show_urls = 'footnote').
• 13635: LaTeX: if a cell contains a table, row coloring is turned off for the next table cells.
• 13685: gettext: Correctly ignore trailing backslashes.
• 13712: intersphinx: Don't add "v" prefix to non-numeric versions.
• 13688: HTML builder: Replace <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>`.
• 13812 (discussion): LaTeX: long :rst:dir:`confval` value does not wrap at spaces in PDF.
• 10785: Autodoc: Allow type aliases defined in the project to be properly cross-referenced when used as type annotations. This makes it possible for objects documented as :py:data: to be hyperlinked in function signatures.
• 13858: doctest: doctest blocks are now correctly added to a group defined by the configuration variable doctest_test_doctest_blocks.
• 13885: Coverage builder: Fix TypeError when warning about missing modules.
• 13929: Duplicate equation label warnings now have a new warning sub-type, ref.equation.
• 13935: autoclass: parent class members no longer considered directly defined in certain cases, depending on autodoc processing order.
• 13939: LaTeX: page break can separate admonition title from contents.
• 14004: Fix :confval:autodoc_type_aliases when they appear in PEP 604
• 14059: LaTeX: Footnotes cause pdflatex error with French language (since late June 2025 upstream change to LaTeX babel-french).
• 13916: HTML Search: do not clear text fragments from the URL on page load.
• 13944: autodoc: show traceback during import in human readable representation.
• 14006: Support images with data URIs that aren't base64-encoded.
• 12797: Fix Some type variables (...) are not listed in Generic[...] TypeError when inheriting from both Generic and autodoc mocked class.
• 13945: autodoc: Fix handling of undefined names in annotations by using the FORWARDREF :mod:annotationlib format.
• 14067: EPUB: unify path separators in manifest items to forward slashes; resolve duplicates in the manifest on Windows.
• 13741: text builder: fix an infinite loop when processing CSV tables.
• 13217: Remove extra parentheses from :rst:dir:`js:function` arguments and errors.

[Bruce Dubbs]

This package needs roman_numerals-3.1.0.tar.gz NOT roman_numerals_py-3.1.0.tar.gz even though the contents of the two are virtually identical.

diff -u roman_numerals{,_py}-3.1.0/PKG-INFO
--- roman_numerals-3.1.0/PKG-INFO       1969-12-31 18:00:00.000000000 -0600
+++ roman_numerals_py-3.1.0/PKG-INFO    1969-12-31 18:00:00.000000000 -0600
@@ -1,5 +1,5 @@
 Metadata-Version: 2.4
-Name: roman-numerals
+Name: roman-numerals-py
 Version: 3.1.0
 Summary: Manipulate well-formed Roman numerals
 Author: Adam Turner
@@ -26,7 +26,7 @@
 Requires-Dist: pytest>=8 ; extra == "test"
 Project-URL: Changelog, https://github.com/AA-Turner/roman-numerals/blob/master/CHANGES.rst
 Project-URL: Code, https://github.com/AA-Turner/roman-numerals/
-Project-URL: Download, https://pypi.org/project/roman-numerals/
+Project-URL: Download, https://pypi.org/project/roman-numerals-py/
 Project-URL: Issue tracker, https://github.com/AA-Turner/roman-numerals/issues
 Provides-Extra: lint
 Provides-Extra: test

[Bruce Dubbs]

Fixed at commits

5dfea51f26 Update to cython-3.2.2 (Python module).
ce5e8f3595 Update to sphinx-9.0.0 (Python module).
6deececcd5 Update to hwdata-0.402.
795a4f8743 Update to xscreensaver-6.13.

[Bruce Dubbs]

Now version 9.0.3

[Bruce Dubbs]

Release 9.0.1 (released Dec 01, 2025)

Bugs fixed

• autodoc: Restore the mapping interface for options objects.
• autodoc: Deprecate the mapping interface for options objects.
• Update translations.

Release 9.0.2 (released Dec 03, 2025)

Bugs fixed

• autodoc: Restore :mod:!sphinx.ext.autodoc.mock.

Release 9.0.3 (released Dec 04, 2025)

Bugs fixed

• autodoc: Restore some missing exports in :mod:!sphinx.ext.autodoc.

[Bruce Dubbs]

Fixed (again) at commit ad0ce24167.

[Bruce Dubbs]

Now version 9.0.4.

[Bruce Dubbs]

Release 9.0.4 (in development)

Bugs fixed

• Fix spurious build warnings when translators reorder references in strings, or use translated display text in references.

[Joe Locash]

Replying to Bruce Dubbs:

This package needs roman_numerals-3.1.0.tar.gz NOT roman_numerals_py-3.1.0.tar.gz even though the contents of the two are virtually identical.

I ran into this last night. It seems roman-numerals renamed their package name internally:

​https://github.com/AA-Turner/roman-numerals/commit/cc8ec3aca53c9246965500f8fc14aee636fd5307

Sphinx adopted the change:

​https://github.com/sphinx-doc/sphinx/commit/2c3e22e3e8e743960792647005fb71cbd1354969

There is an open ticket ticket about in roman-numerals upstream:

​https://github.com/AA-Turner/roman-numerals/issues/87

Switching to the roman-numerals (no -py) module fixed my build.

[Bruce Dubbs]

Replying to Joe Locash:

Replying to Bruce Dubbs:

This package needs roman_numerals-3.1.0.tar.gz NOT roman_numerals_py-3.1.0.tar.gz even though the contents of the two are virtually identical.

I ran into this last night. It seems roman-numerals renamed their package name internally:

I thought I updated this already. I just did that at commit 0c397914f0.

[Bruce Dubbs]

Release 9.0.4 (released Dec 04, 2025)

Bugs fixed

• #14143: Fix spurious build warnings when translators reorder references in strings, or use translated display text in references.

[Bruce Dubbs]

Fixed at commits

42f5d90fd6 Update to SPIRV-Headers and SPIRV-Tools 1.4.335.0.
f12c346131 Update to Vulkan-Headers and Vulkan-Loader 1.4.335.0.
bcf8738f87 Update to sphinx-9.0.4 (Python module).

[Bruce Dubbs]

Milestone renamed