# What changed in sphinx

> 14 changes in sphinx 9 from its official release notes, upgrade guides and advisories: 2 breaking, 1 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/pypi/sphinx/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## sphinx 9

### Breaking changes

- Docutils 0.20 is no longer supported. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Python 3.11 is no longer supported. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)

### New APIs and options

- Adds an API for copying static assets from extensions to the build output. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)

### Fixes and other changes

- Fixes LaTeX builds for documents using the standard `acronym` role. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes default option parsing in autodoc. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Improves autodoc support for objects that cannot be weak-referenced. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes creating `HTMLThemeFactory` objects in third-party extensions. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes PDF build crashes when a code block contains more than circa 1350 code lines. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes LaTeX rendering of grid-filled merged vertical cells and footer overruns involving merged vertical table cells. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes compatibility with MyST-Parser. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes duplicate `:no-index-entry:` entries for modules in autodoc. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixes TAB characters ending up in `sphinxVerbatim` so they obey tab stops. (9.1.0) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.1.0)
- Fixed spurious build warnings when translators reorder references in strings or use translated display text in references. (9.0.4) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.0.4)
- Some missing exports in sphinx.ext.autodoc were restored. (9.0.3) — [release notes](https://github.com/sphinx-doc/sphinx/releases/tag/v9.0.3)