Close sphinx-doc#13130 (LaTeX docs about index creation)

jfbu · Nov 17, 2024 · 5b4dfa1 · 5b4dfa1
1 parent 15b46dc
commit 5b4dfa1
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 0 deletions.
diff --git a/CHANGES.rst b/CHANGES.rst
@@ -24,5 +24,9 @@ Bugs fixed
 * #13060: HTML Search: use ``Map`` to store per-file term scores.
   Patch by James Addison
 
+* #13130: LaTeX docs: ``pdflatex`` index creation may fail for index entries
+  in French.  See :confval:`latex_use_xindy`.
+  Patch by Jean-François B.
+
 Testing
 -------
diff --git a/doc/usage/configuration.rst b/doc/usage/configuration.rst
@@ -3157,6 +3157,9 @@ These options influence LaTeX output.
    * The default is :code-py:`False` for :code-py:`'pdflatex'`,
      but :code-py:`True` is recommended for non-English documents as soon
      as some indexed terms use non-ASCII characters from the language script.
+     Attempting to index a term whose first character is non-ASCII
+     will break the build, if :confval:`latex_use_xindy` is left to its
+     default :code-py:`False`.
 
    Sphinx adds some dedicated support to the :program:`xindy` base distribution
    for using :code-py:`'pdflatex'` engine with Cyrillic scripts.