Merge branch 'master' into remove-extras

Author: AA-Turner

.gitattributes

@@ -51,6 +51,8 @@ tests/roots/test-pycode/cp_1251_coded.py dos
 
 # Non UTF-8 encodings
 tests/roots/test-pycode/cp_1251_coded.py working-tree-encoding=windows-1251
+tests/roots/test-root/wrongenc.inc working-tree-encoding=latin-1
+tests/roots/test-warnings/wrongenc.inc working-tree-encoding=latin-1
 
 # Generated files
 # https://github.com/github/linguist/blob/master/docs/overrides.md
@@ -62,4 +64,5 @@ tests/roots/test-pycode/cp_1251_coded.py working-tree-encoding=windows-1251
 
 tests/js/fixtures/**/*.js                           generated
 sphinx/search/minified-js/*.js                      generated
+sphinx/search/_stopwords/                           generated
 sphinx/themes/bizstyle/static/css3-mediaqueries.js  generated

.github/workflows/lint.yml

@@ -123,3 +123,21 @@ jobs:
       run: |
         python -m build .
         twine check dist/*
+
+  prettier:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: "20"
+        cache: "npm"
+    - run: >
+        npx prettier@3.5
+        --check
+        "sphinx/themes/**/*.js"
+        "!sphinx/themes/bizstyle/static/css3-mediaqueries*.js"
+        "tests/js/**/*.{js,mjs}"
+        "!tests/js/fixtures/**"

.github/workflows/main.yml

@@ -41,6 +41,7 @@ jobs:
         docutils:
         - "0.20"
         - "0.21"
+        - "0.22"
 #        include:
 #        # test every supported Docutils version for the latest supported Python
 #        - python: "3.13"
@@ -89,9 +90,11 @@ jobs:
       matrix:
         python:
         - "3.14"
+        - "3.15"
         docutils:
         - "0.20"
         - "0.21"
+        - "0.22"
 
     steps:
     - uses: actions/checkout@v4
@@ -125,6 +128,7 @@ jobs:
       matrix:
         python:
         - "3.14"
+        - "3.15"
 
     steps:
     - uses: actions/checkout@v4

.gitignore

@@ -3,6 +3,7 @@
 *.so
 *.swp
 
+.auto/
 .dir-locals.el
 .cache/
 .idea

.prettierrc.toml

@@ -0,0 +1,2 @@
+# https://prettier.io/docs/options
+experimentalOperatorPosition = "start"

AUTHORS.rst

@@ -83,6 +83,7 @@ Contributors
 * 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
@@ -102,6 +103,8 @@ Contributors
 * 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
 * Thomas Lamb -- linkcheck builder

CHANGES.rst

@@ -4,12 +4,41 @@ Release 8.3.0 (in development)
 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.
+
 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.
+* #13679: Non-decodable characters in source files will raise an error in Sphinx 9.
+  Currently, such bytes are replaced with '?' along with logging a warning.
+  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.
+
 Features added
 --------------
 
@@ -19,12 +48,64 @@ Features added
 * #13439: linkcheck: Permit warning on every redirect with
   ``linkcheck_allowed_redirects = {}``.
   Patch by Adam Turner.
+* #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.
+* #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.
 
 Bugs fixed
 ----------
 
+* #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.
 
 Testing
 -------

doc/changes/5.3.rst

@@ -8,7 +8,10 @@ Release 5.3.0 (released Oct 16, 2022)
 
 * #10759: LaTeX: add :confval:`latex_table_style` and support the
   ``'booktabs'``, ``'borderless'``, and ``'colorrows'`` styles.
-  (thanks to Stefan Wiehler for initial pull requests #6666, #6671)
+  (thanks to Stefan Wiehler for initial pull requests #6666, #6671).
+  Using the ``'booktabs'`` style solves #6740 (Removing LaTeX
+  column borders for automatic colspec).
+  Patch by Jean-François B.
 * #10840: One can cross-reference including an option value like
   ``:option:`--module=foobar```, ``:option:`--module[=foobar]```,
   or ``:option:`--module foobar```.

doc/changes/7.3.rst

@@ -86,7 +86,7 @@ Dependencies
 
 * #11858: Increase the minimum supported version of Alabaster to 0.7.14.
   Patch by Adam Turner.
-* #11411: Support `Docutils 0.21`_. Patch by Adam Turner.
+* #12267: Support `Docutils 0.21`_. Patch by Adam Turner.
 
   .. _Docutils 0.21: https://docutils.sourceforge.io/RELEASE-NOTES.html#release-0-21-2024-04-09
 * #12012: Use ``types-docutils`` instead of ``docutils-stubs``.

doc/conf.py

@@ -297,14 +297,12 @@ def linkify_issues_in_changelog(
 ) -> None:
     """Linkify issue references like #123 in changelog to GitHub."""
     if docname == 'changes':
+        linkified_changelog = re.sub(r'(?:PR)?#([0-9]+)\b', _linkify, source[0])
+        source[0] = linkified_changelog
 
-        def linkify(match: re.Match[str]) -> str:
-            url = 'https://github.com/sphinx-doc/sphinx/issues/' + match[1]
-            return f'`{match[0]} <{url}>`_'
-
-        linkified_changelog = re.sub(r'(?:PR)?#([0-9]+)\b', linkify, source[0])
 
-        source[0] = linkified_changelog
+def _linkify(match: re.Match[str], /) -> str:
+    return f'`{match[0]} <https://github.com/sphinx-doc/sphinx/issues/{match[1]}>`__'
 
 
 REDIRECT_TEMPLATE = """