Merge branch 'master' into literallyinclude-options

.github/workflows/main.yml

@@ -102,6 +102,43 @@ jobs:
       env:
         PYTHONWARNINGS: "error"  # treat all warnings as errors
 
+  deadsnakes-free-threraded:
+    runs-on: ubuntu-latest
+    name: Python ${{ matrix.python }} (Docutils ${{ matrix.docutils }}; free-threaded)
+    strategy:
+      fail-fast: false
+      matrix:
+        python:
+        - "3.13-dev"
+        docutils:
+        - "0.20"
+        - "0.21"
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.python }} (deadsnakes)
+      uses: deadsnakes/[email protected]
+      with:
+        python-version: ${{ matrix.python }}
+        nogil: true
+    - name: Check Python version
+      run: python --version --version
+    - name: Install graphviz
+      run: sudo apt-get install graphviz
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        python -m pip install .[test]
+    - name: Install Docutils ${{ matrix.docutils }}
+      run: python -m pip install --upgrade "docutils~=${{ matrix.docutils }}.0"
+    # markupsafe._speedups has not declared that it can run safely without the GIL
+    - name: Remove markupsafe._speedups
+      run: rm -rf "$(python -c 'from markupsafe._speedups import __file__ as f; print(f)')"
+    - name: Test with pytest
+      run: python -m pytest -vv --durations 25
+      env:
+        PYTHONWARNINGS: "error"  # treat all warnings as errors
+
   windows:
     runs-on: windows-2019
     name: Windows

CHANGES.rst

@@ -28,8 +28,13 @@ Features added
 
 * #11328: Mention evaluation of templated content during production of static
   output files.
+* #12704: LaTeX: make :dudir:`contents <table-of-contents>`, :dudir:`topic`,
+  and :dudir:`sidebar` directives separately customizable for PDF output.
+  Patch by Jean-François B. and Bénédikt Tran.
 * #12474: Support type-dependent search result highlighting via CSS.
   Patch by Tim Hoffmann.
+* #12652: LaTeX: Add :confval:`math_numsep` support to latex builder.
+  Patch by Thomas Fanning and Jean-François B.
 * #12743: No longer exit on the first warning when
   :option:`--fail-on-warning <sphinx-build --fail-on-warning>` is used.
   Instead, exit with a non-zero status if any warnings were generated
@@ -45,11 +50,18 @@ Bugs fixed
 * #12514: intersphinx: fix the meaning of a negative value for
   :confval:`intersphinx_cache_limit`.
   Patch by Shengyu Zhang.
+* #12722: LaTeX: avoid TeX reporting ``Overfull \hbox`` from too long
+  strings in a codeline when the problem has actually been solved thanks
+  to :ref:`latexsphinxsetupforcewraps`.
+  Patch by Jean-François B.
 * #12730: The ``UnreferencedFootnotesDetector`` transform has been improved
   to more consistently detect unreferenced footnotes.
   Note, the priority of the transform has been changed from 200 to 622,
   so that it now runs after the docutils ``Footnotes`` resolution transform.
   Patch by Chris Sewell.
+* #12778: LaTeX: let :ref:`'sphinxsetup' <latexsphinxsetup>`
+  ``div.topic_box-shadow`` key if used with only one dimension set both
+  x-offset and y-offset as per documentation.
 * #12587: Do not warn when potential ambiguity detected during Intersphinx
   resolution occurs due to duplicate targets that differ case-insensitively.
   Patch by James Addison.
@@ -62,6 +74,10 @@ Bugs fixed
   get passed to :program:`latexmk`.  Let :option:`-Q <sphinx-build -Q>`
   (silent) apply as well to the PDF build phase.
   Patch by Jean-François B.
+* #12744: LaTeX: Classes injected by a custom interpreted text role now give
+  rise to nested ``\DUrole``'s, rather than a single one with comma separated
+  classes.
+  Patch by Jean-François B.
 * #11970, #12551: singlehtml builder: make target URIs to be same-document
   references in the sense of :rfc:`RFC 3986, §4.4 <3986#section-4.4>`,
   e.g., ``index.html#foo`` becomes ``#foo``.

doc/changes/7.4.rst

@@ -217,7 +217,8 @@ Bugs fixed
 * #12410: LaTeX: for French and ``'lualatex'`` as :confval:`latex_engine`
   use ``babel`` as with ``'xelatex'`` (and not ``polyglossia``).
   Patch by Jean-François B.
-* #12520: LaTeX: let :rst:dir:`todolist` produce correct hyperlinks in PDF.
+* #8807, #12520: LaTeX: let :rst:dir:`todolist` produce correct hyperlinks
+  in PDF.
   Patch by Jean-François B.
 * #12416: Ensure that configuration setting aliases are always synchronised
   when one value or the other is modified.