Sphinx 9.0.0rc4__tar.gz → 9.1.0rc2__tar.gz

sphinx-9.1.0rc2/AUTHORS.rst

@@ -0,0 +1,143 @@
+Maintainers
+===========
+
+*Listed alphabetically in forename, surname order*
+
+* Adam Turner <@AA-Turner>
+* Bénédikt Tran <@picnixz>
+* Chris Sewell <@chrisjsewell>
+* François Freitag <@francoisfreitag>
+* Jakob Lykke Andersen <@jakobandersen>
+* Jean-François B. <@jfbu>
+* Stephen Finucane <@stephenfin>
+* Takayuki Shimizukawa <@shimizukawa>
+* Takeshi Komiya <@tk0miya>
+
+Contributors
+============
+
+*Listed alphabetically in forename, surname order*
+
+* Aaron Carlisle -- basic theme and templating improvements
+* Adam Dangoor -- improved static typing
+* Adrián Chaves (Gallaecio) -- coverage builder improvements
+* Alastair Houghton -- Apple Help builder
+* Alex Gaynor -- linkcheck retry on errors
+* Alexander Todorov -- inheritance_diagram tests and improvements
+* Andi Albrecht -- agogo theme
+* Antonio Valentino -- qthelp builder, docstring inheritance
+* Antti Kaihola -- doctest extension (skipif option)
+* Barry Warsaw -- setup command improvements
+* Bart Kamphorst -- warning improvements
+* Ben Egan -- Napoleon improvements & viewcode improvements
+* Benjamin Peterson -- unittests
+* Blaise Laflamme -- pyramid theme
+* Brecht Machiels -- builder entry-points
+* Bruce Mitchener -- Minor epub improvement
+* Buck Evan -- dummy builder
+* Charles Duffy -- original graphviz extension
+* Chris Barrick -- Napoleon type preprocessing logic
+* Chris Holdgraf -- improved documentation structure
+* Chris Lamb -- reproducibility fixes
+* Christopher Perkins -- autosummary integration
+* Dan MacKinlay -- metadata fixes
+* Daniel Bültmann -- todo extension
+* Daniel Eades -- improved static typing
+* Daniel Hahler -- testing and CI improvements
+* Daniel Pizetta -- inheritance diagram improvements
+* Dave Hoese -- ``sphinx.ext.viewcode`` and ``sphinx.ext.apidoc`` bug fixes
+* Dave Kuhlman -- original LaTeX writer
+* Dimitri Papadopoulos Orfanos -- linting and spelling
+* Dmitry Shachnev -- modernisation and reproducibility
+* Doug Hellmann -- graphviz improvements
+* Eric Larson -- better error messages
+* Eric N. Vander Weele -- autodoc improvements
+* Eric Wieser -- autodoc improvements
+* Erik Bedard -- config options for :mod:`sphinx.ext.duration`
+* Etienne Desautels -- apidoc module
+* Ezio Melotti -- collapsible sidebar JavaScript
+* Filip Vavera -- napoleon todo directive
+* Florian Best -- log improvements
+* Glenn Matthews -- python domain signature improvements
+* Gregory Szorc -- performance improvements
+* Günter Milde -- various small fixes
+* Henrique Bastos -- SVG support for graphviz extension
+* Hernan Grecco -- search improvements
+* Hong Xu -- svg support in imgmath extension and various bug fixes
+* Horst Gutmann -- internationalization support
+* Hugo van Kemenade -- support FORCE_COLOR and NO_COLOR
+* Ian Hunt-Isaak -- typealias reference improvement
+* Ian Lee -- quickstart improvements
+* Jacob Mason -- websupport library (GSOC project)
+* James Addison -- linkcheck and HTML search improvements
+* Jeppe Pihl -- literalinclude improvements
+* Jeremy Maitin-Shepard -- C++ domain improvements
+* Joel Wurtz -- cellspanning support in LaTeX
+* John Waltman -- Texinfo builder
+* Jon Dufresne -- modernisation
+* Josip Dzolonga -- coverage builder
+* Juan Luis Cano Rodríguez -- new tutorial (2021)
+* Julien Palard -- Colspan and rowspan in text builder
+* Justus Magin -- napoleon improvements
+* Kazuya Take -- ``sphinx.testing.path`` bug fix
+* Kevin Dunn -- MathJax extension
+* KINEBUCHI Tomohiko -- typing Sphinx as well as docutils
+* Kurt McKee -- documentation updates
+* Lars Hupfeldt Nielsen - OpenSSL FIPS mode md5 bug fix
+* Louis Maddox -- better docstrings
+* Łukasz Langa -- partial support for autodoc
+* Marco Buttu -- doctest extension (pyversion option)
+* Mark Ostroth -- semantic HTML contributions
+* Martin Hans -- autodoc improvements
+* Martin Larralde -- additional napoleon admonitions
+* Martin Liška -- option directive and role improvements
+* Martin Mahner -- nature theme
+* Martin Matouš -- initial support for PEP 695
+* Matthew Fernandez -- todo extension fix
+* Matthew Woodcraft -- text output improvements
+* Matthias Geier -- style improvements
+* Michael Droettboom -- inheritance_diagram extension
+* Michael Wilson -- Intersphinx HTTP basic auth support
+* Nathan Damon -- bugfix in validation of static paths in html builders
+* Nils Kattenbeck -- pygments dark style
+* Pauli Virtanen -- autodoc improvements, autosummary extension
+* Rafael Fontenelle -- internationalisation
+* \A. Rafey Khan -- improved intersphinx typing
+* Rui Pinheiro -- Python 3.14 forward references support
+* Roland Meister -- epub builder
+* Sebastian Wiesner -- image handling, distutils support
+* Slawek Figiel -- additional warning suppression
+* Stefan Seefeld -- toctree improvements
+* Stefan van der Walt -- autosummary extension
+* Steve Piercy -- documentation improvements
+* Szymon Karpinski -- intersphinx improvements
+* \T. Powers -- HTML output improvements
+* Taku Shimizu -- epub3 builder
+* Tamika Nomara -- bug fixes
+* Thomas Lamb -- linkcheck builder
+* Thomas Waldmann -- apidoc module fixes
+* Till Hoffmann -- doctest option to exit after first failed test
+* Tim Hoffmann -- theme improvements
+* Valentin Heinisch -- warning types improvement
+* Victor Wheeler -- documentation improvements
+* Vince Salvino -- JavaScript search improvements
+* Will Maier -- directory HTML builder
+* Zac Hatfield-Dodds -- doctest reporting improvements, intersphinx performance
+
+Former maintainers
+==================
+
+*Listed alphabetically in forename, surname order*
+
+Former maintainers are those who haven't committed in the last two years.
+Those on the list below may become active maintainers again at any time.
+
+* Armin Ronacher <@mitsuhiko>
+* Daniel Neuhäuser <@DasIch>
+* Georg Brandl <georg@python.org>
+* Rob Ruana <@RobRuana>
+* Robert Lehmann <@lehmannro>
+* Timotheus Kampik <@TimKam>
+* Yoshiki Shibukawa <@shibukawa>
+
+Many thanks for all contributions!

sphinx-9.1.0rc2/CHANGES.rst

@@ -0,0 +1,49 @@
+Release 9.1.0 (in development)
+==============================
+
+Dependencies
+------------
+
+* #14153: Drop Python 3.11 support.
+* #12555: Drop Docutils 0.20 support.
+  Patch by Adam Turner
+
+Incompatible changes
+--------------------
+
+Deprecated
+----------
+
+Features added
+--------------
+
+Bugs fixed
+----------
+
+* #14189: autodoc: Fix duplicate ``:no-index-entry:`` for modules.
+  Patch by Adam Turner
+* #13713: Fix compatibility with MyST-Parser.
+  Patch by Adam Turner
+* Fix tests for Python 3.15.
+  Patch by Adam Turner
+* #14089: autodoc: Fix default option parsing.
+  Patch by Adam Turner
+* Remove incorrect static typing assertions.
+  Patch by Adam Turner
+* #14050: LaTeXTranslator fails to build documents using the "acronym"
+  standard role.
+  Patch by Günter Milde
+* LaTeX: Fix rendering for grid filled merged vertical cell.
+  Patch by Tim Nordell
+* #14207: Fix creating ``HTMLThemeFactory`` objects in third-party extensions.
+  Patch by Adam Turner
+* #3099: LaTeX: Fix PDF build crashes if a code-block contains more than
+  circa 1350 codelines (about 27 a4-sized pages at default pointsize).
+  Patch by Jean-François B.
+* #14064: LaTeX: TABs ending up in sphinxVerbatim fail to obey tab stops.
+  Patch by Jean-François B.
+* #14089: autodoc: Improve support for non-weakreferencable objects.
+  Patch by Adam Turner
+
+Testing
+-------

sphinx-9.1.0rc2/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: Sphinx
+Version: 9.1.0rc2
+Summary: Python documentation generator
+Author-email: Adam Turner <aa-turner@users.noreply.github.com>, Georg Brandl <georg@python.org>
+Requires-Python: >=3.12
+Description-Content-Type: text/x-rst
+License-Expression: BSD-2-Clause
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Information Technology
+Classifier: Intended Audience :: Other Audience
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Framework :: Sphinx
+Classifier: Framework :: Sphinx :: Domain
+Classifier: Framework :: Sphinx :: Extension
+Classifier: Framework :: Sphinx :: Theme
+Classifier: Topic :: Documentation
+Classifier: Topic :: Documentation :: Sphinx
+Classifier: Topic :: Education
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management
+Classifier: Topic :: Internet :: WWW/HTTP :: Site Management :: Link Checking
+Classifier: Topic :: Printing
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Editors :: Documentation
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Text Processing :: General
+Classifier: Topic :: Text Processing :: Indexing
+Classifier: Topic :: Text Processing :: Markup
+Classifier: Topic :: Text Processing :: Markup :: HTML
+Classifier: Topic :: Text Processing :: Markup :: LaTeX
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Text Processing :: Markup :: reStructuredText
+Classifier: Topic :: Text Processing :: Markup :: XML
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+License-File: LICENSE.rst
+Requires-Dist: sphinxcontrib-applehelp>=1.0.7
+Requires-Dist: sphinxcontrib-devhelp>=1.0.6
+Requires-Dist: sphinxcontrib-htmlhelp>=2.0.6
+Requires-Dist: sphinxcontrib-jsmath>=1.0.1
+Requires-Dist: sphinxcontrib-qthelp>=1.0.6
+Requires-Dist: sphinxcontrib-serializinghtml>=1.1.9
+Requires-Dist: Jinja2>=3.1
+Requires-Dist: Pygments>=2.17
+Requires-Dist: docutils>=0.21,<0.23
+Requires-Dist: snowballstemmer>=2.2
+Requires-Dist: babel>=2.13
+Requires-Dist: alabaster>=0.7.14
+Requires-Dist: imagesize>=1.3
+Requires-Dist: requests>=2.30.0
+Requires-Dist: roman-numerals>=1.0.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: colorama>=0.4.6; sys_platform == 'win32'
+Project-URL: Changelog, https://www.sphinx-doc.org/en/master/changes.html
+Project-URL: Code, https://github.com/sphinx-doc/sphinx
+Project-URL: Documentation, https://www.sphinx-doc.org/
+Project-URL: Download, https://pypi.org/project/Sphinx/
+Project-URL: Homepage, https://www.sphinx-doc.org/
+Project-URL: Issue tracker, https://github.com/sphinx-doc/sphinx/issues
+
+========
+ Sphinx
+========
+
+.. image:: https://img.shields.io/pypi/v/sphinx.svg
+   :target: https://pypi.org/project/Sphinx/
+   :alt: Package on PyPI
+
+.. image:: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml/badge.svg
+   :target: https://github.com/sphinx-doc/sphinx/actions/workflows/main.yml
+   :alt: Build Status
+
+.. image:: https://readthedocs.org/projects/sphinx/badge/?version=master
+   :target: https://www.sphinx-doc.org/
+   :alt: Documentation Status
+
+.. image:: https://img.shields.io/badge/License-BSD%202--Clause-blue.svg
+   :target: https://opensource.org/licenses/BSD-2-Clause
+   :alt: BSD 2 Clause
+
+**Sphinx makes it easy to create intelligent and beautiful documentation.**
+
+Sphinx uses reStructuredText as its markup language, and many of its strengths
+come from the power and straightforwardness of reStructuredText and its parsing
+and translating suite, the Docutils.
+
+Features
+========
+
+* **Output formats**: HTML, PDF, plain text, EPUB, TeX, manual pages, and more
+* **Extensive cross-references**: semantic markup and automatic links
+  for functions, classes, glossary terms and similar pieces of information
+* **Hierarchical structure**: easy definition of a document tree, with automatic
+  links to siblings, parents and children
+* **Automatic indices**: general index as well as a module index
+* **Code highlighting**: automatic highlighting using the Pygments highlighter
+* **Templating**: Flexible HTML output using the Jinja 2 templating engine
+* **Extension ecosystem**: Many extensions are available, for example for
+  automatic function documentation or working with Jupyter notebooks.
+* **Language Support**: Python, C, C++, JavaScript, mathematics, and many other
+  languages through extensions.
+
+For more information, refer to `the documentation`_.
+
+Installation
+============
+
+The following command installs Sphinx from the `Python Package Index`_. You will
+need a working installation of Python and pip.
+
+.. code-block:: shell
+
+   pip install -U sphinx
+
+Contributing
+============
+
+We appreciate all contributions! Refer to `the contributors guide`_ for
+information.
+
+.. _the documentation: https://www.sphinx-doc.org/
+.. _the contributors guide: https://www.sphinx-doc.org/en/master/internals/contributing.html
+.. _Python Package Index: https://pypi.org/project/Sphinx/
+

sphinx-9.1.0rc2/doc/changes/9.0.rst

@@ -0,0 +1,244 @@
+==========
+Sphinx 9.0
+==========
+
+
+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.
+  Patch by Matt Wang.
+
+Release 9.0.3 (released Dec 04, 2025)
+=====================================
+
+Bugs fixed
+----------
+
+* #14142: autodoc: Restore some missing exports in :mod:`!sphinx.ext.autodoc`.
+  Patch by Adam Turner.
+
+Release 9.0.2 (released Dec 03, 2025)
+=====================================
+
+Bugs fixed
+----------
+
+* #14142: autodoc: Restore :mod:`!sphinx.ext.autodoc.mock`.
+  Patch by Adam Turner.
+
+Release 9.0.1 (released Dec 01, 2025)
+=====================================
+
+Bugs fixed
+----------
+
+* #13942: autodoc: Restore the mapping interface for options objects.
+  Patch by Adam Turner.
+* #13942: autodoc: Deprecate the mapping interface for options objects.
+  Patch by Adam Turner.
+* #13387: Update translations.
+
+Release 9.0.0 (released Nov 30, 2025)
+=====================================
+
+Dependencies
+------------
+
+* #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
+
+Incompatible changes
+--------------------
+
+* #13639: :py:meth:`!SphinxComponentRegistry.create_source_parser` no longer
+  has an *app* parameter, instead taking *config* and *env*.
+  Patch by Adam Turner.
+* #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.
+  Patch by Adam Turner.
+* #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.
+  Patches by Adam Turner.
+* #13355: Don't include escaped title content in the search index.
+  Patch by Will Lachance.
+
+Deprecated
+----------
+
+* 13627: Deprecate remaining public :py:attr:`!.app` attributes,
+  including ``builder.app``, ``env.app``, ``events.app``,
+  and ``SphinxTransform.app``.
+  Patch by Adam Turner.
+* #13637: Deprecate the :py:meth:`!set_application` method
+  of :py:class:`~sphinx.parsers.Parser` objects.
+  Patch by Adam Turner.
+* #13644: Deprecate the :py:attr:`!Parser.config` and :py:attr:`!env` attributes.
+  Patch by Adam Turner.
+* #13665: Deprecate support for non-UTF 8 source encodings,
+  scheduled for removal in Sphinx 10.
+  Patch by Adam Turner.
+* #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.
+  Patch by Adam Turner.
+* #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.
+  Patch by Adam Turner.
+
+Features added
+--------------
+
+* #13332: Add :confval:`doctest_fail_fast` option to exit after the first failed
+  test.
+  Patch by Till Hoffmann.
+* #13439: linkcheck: Permit warning on every redirect with
+  ``linkcheck_allowed_redirects = {}``.
+  Patch by Adam Turner and James Addison.
+* #13497: Support C domain objects in the table of contents.
+* #13500: LaTeX: add support for ``fontawesome6`` package.
+  Patch by Jean-François B.
+* #13509: autodoc: Detect :py:func:`typing_extensions.overload <typing.overload>`
+  and :py:func:`~typing.final` decorators.
+  Patch by Spencer Brown.
+* #13535: html search: Update to the latest version of Snowball (v3.0.1).
+  Patch by Adam Turner.
+* #13647: LaTeX: allow more cases of table nesting.
+  Patch by Jean-François B.
+* #13657: LaTeX: support CSS3 length units.
+  Patch by Jean-François B.
+* #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.
+  Patch by Adam Turner.
+* #13805: LaTeX: add support for ``fontawesome7`` package.
+  Patch by Jean-François B.
+* #13508: autodoc: Initial support for :pep:`695` type aliases.
+  Patch by Martin Matouš, Jeremy Maitin-Shepard, and Adam Turner.
+* #14023: Add the new :confval:`mathjax_config_path` option
+  to load MathJax configuration from a file.
+  Patch by Randolf Scholz and Adam Turner.
+* #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.
+  Patch by Fazeel Usmani and James Addison.
+* #14075: autosummary: Provide more context in import exception stack traces.
+  Patch by Philipp A.
+* #13468: Add config options to :mod:`sphinx.ext.duration`.
+  Patch by Erik Bedard and Adam Turner.
+* #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.
+  Patch by Matthias Geier.
+* #14029: intersphinx: Fix error in format string interpolation.
+  Patch by Matthieu de Cibeins.
+* #13894: Add ``source_code_parser`` type to :confval:`suppress_warnings`
+  for grouping issues related to the C and C++ parsers.
+  Patch by Valentin H.
+
+Bugs fixed
+----------
+
+* #13926: multiple py:type directives for the same canonical type no
+  longer result in spurious duplicate object description warnings.
+  Patch by Jeremy Maitin-Shepard.
+* #1327: LaTeX: tables using longtable raise error if
+  :rst:dir:`tabularcolumns` specifies automatic widths
+  (``L``, ``R``, ``C``, or ``J``).
+  Patch by Jean-François B.
+* #3447: LaTeX: when assigning longtable class to table for PDF, it may render
+  "horizontally" and overflow in right margin.
+  Patch by Jean-François B.
+* #8828: LaTeX: adding a footnote to a longtable cell causes table to occupy
+  full width.
+  Patch by Jean-François B.
+* #11498: LaTeX: Table in cell fails to build if it has many rows.
+  Patch by Jean-François B.
+* #11515: LaTeX: longtable does not allow nested table.
+  Patch by Jean-François B.
+* #11973: LaTeX: links in table captions do not work in PDF.
+  Patch by Jean-François B.
+* #12821: LaTeX: URLs/links in section titles should render in PDF.
+  Patch by Jean-François B.
+* #13369: Correctly parse and cross-reference unpacked type annotations.
+  Patch by Alicia Garcia-Raboso.
+* #13528: Add tilde ``~`` prefix support for :rst:role:`py:deco`.
+  Patch by Shengyu Zhang and Adam Turner.
+* #13597: LaTeX: table nested in a merged cell leads to invalid LaTeX mark-up
+  and PDF cannot be built.
+  Patch by Jean-François B.
+* #13619: LaTeX: possible duplicated footnotes in PDF from object signatures
+  (typically if :confval:`latex_show_urls` ``= 'footnote'``).
+  Patch by Jean-François B.
+* #13635: LaTeX: if a cell contains a table, row coloring is turned off for
+  the next table cells.
+  Patch by Jean-François B.
+* #13685: gettext: Correctly ignore trailing backslashes.
+  Patch by Bénédikt Tran.
+* #13712: intersphinx: Don't add "v" prefix to non-numeric versions.
+  Patch by Szymon Karpinski.
+* #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>`__.
+  Patch by Mark Ostroth.
+* #13812 (discussion): LaTeX: long :rst:dir:`confval` value does not wrap at
+  spaces in PDF.
+  Patch by Jean-François B.
+* #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.
+  Patch by Damien Ayers.
+* #13929: Duplicate equation label warnings now have a new warning
+  sub-type, ``ref.equation``.
+  Patch by Jared Dillard.
+* #13935: autoclass: parent class members no longer considered
+  directly defined in certain cases, depending on autodoc processing
+  order.
+  Patch by Jeremy Maitin-Shepard.
+* #13939: LaTeX: page break can separate admonition title from contents.
+  Patch by Jean-François B.
+* #14004: Fix :confval:`autodoc_type_aliases` when they appear in PEP 604
+  union syntax (``Alias | Type``).
+  Patch by Tamika Nomara.
+* #14059: LaTeX: Footnotes cause pdflatex error with French language
+  (since late June 2025 upstream change to LaTeX ``babel-french``).
+  Patch by Jean-François B.
+* #13916: HTML Search: do not clear text fragments from the URL on page load.
+  Patch by Harmen Stoppels.
+* #13944: autodoc: show traceback during import in human readable representation.
+  Patch by Florian Best.
+* #14006: Support images with data URIs that aren't base64-encoded.
+  Patch by Shengyu Zhang and Adam Turner.
+* #12797: Fix ``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.
+* #13945: autodoc: Fix handling of undefined names in annotations by using
+  the ``FORWARDREF`` :mod:`annotationlib` format.
+  Patch by Rui Pinheiro and Adam Turner.
+* #14067: EPUB: unify path separators in manifest items to forward slashes;
+  resolve duplicates in the manifest on Windows.
+  Patch by Akihiro Takizawa.
+* #13741: text builder: fix an infinite loop when processing CSV tables.
+  Patch by Bénédikt Tran.
+* #13217: Remove extra parentheses from :rst:dir:`js:function` arguments and errors.
+  Patch by Shengyu Zhang.

sphinx-9.1.0rc2/doc/changes/index.rst

@@ -0,0 +1,74 @@
+.. _changes:
+
+=========
+Changelog
+=========
+
+.. raw:: latex
+
+   \addtocontents{toc}{\protect\setcounter{tocdepth}{1}}%
+   \makeatletter
+   \addtocontents{toc}%
+   {\def\string\l@section{\string\@dottedtocline{1}{1.5em}{3.3em}}}
+   \addtocontents{toc}%
+   {\def\string\l@subsection{\string\@dottedtocline{2}{4.8em}{4em}}}
+   \makeatother
+
+
+.. include:: ../../CHANGES.rst
+
+
+Prior releases
+==============
+
+.. toctree::
+   :maxdepth: 2
+
+   9.0
+   8.2
+   8.1
+   8.0
+   7.4
+   7.3
+   7.2
+   7.1
+   7.0
+   6.2
+   6.1
+   6.0
+   5.3
+   5.2
+   5.1
+   5.0
+   4.5
+   4.4
+   4.3
+   4.2
+   4.1
+   4.0
+   3.5
+   3.4
+   3.3
+   3.2
+   3.1
+   3.0
+   2.4
+   2.3
+   2.2
+   2.1
+   2.0
+   1.8
+   1.7
+   1.6
+   1.5
+   1.4
+   1.3
+   1.2
+   1.1
+   1.0
+   0.6
+   0.5
+   0.4
+   0.3
+   0.2
+   0.1

sphinx-9.1.0rc2/doc/development/index.rst

@@ -0,0 +1,19 @@
+.. _extending-sphinx:
+
+Extending Sphinx
+================
+
+This guide is aimed at giving a quick introduction for those wishing to
+develop their own extensions for Sphinx.
+Sphinx possesses significant extensibility capabilities
+including the ability to hook into almost every point of the build process.
+If you simply wish to use Sphinx with existing extensions,
+refer to :doc:`/usage/extensions/index`.
+For a more detailed discussion of the extension interface see :doc:`/extdev/index`.
+
+.. toctree::
+   :maxdepth: 2
+
+   tutorials/index
+   howtos/index
+   html_themes/index