gh-139588: Docs: PDF/LaTeX: bump max list depth

[m-aciek]

Prevents LaTeX PDF build error Too deeply nested. (Regression from #135945.)

Thanks @jfbu for the fix suggestion.

Better alternative to #140445.

Could it be labeled for backport on 3.13-3.15 please?

• Issue: make dist-pdf is broken #139588

---

📚 Documentation preview 📚: https://cpython-previews--140709.org.readthedocs.build/

[AA-Turner]

Thanks, I've also increased it to 8 per Jean-François' suggestion.

A

[miss-islington-app]

Thanks @m-aciek for the PR, and @AA-Turner for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖

[bedevere-app]

GH-140724 is a backport of this pull request to the 3.14 branch.

[bedevere-app]

GH-140725 is a backport of this pull request to the 3.13 branch.

[m-aciek]

FYI I discovered yesterday that this PR didn't fully fixed the PDF build issue. Now make all-pdf command in latex build directory still returns non-zero exit code and prevents next PDF file (whatsnew.pdf) to be build when there's no flag --keep-going used, despite the fact that the PDF is rendered correctly.

The error from make all-pdf can be silenced with:

Index: Doc/conf.py
IDEA additional info:
Subsystem: com.intellij.openapi.diff.impl.patch.CharsetEP
<+>UTF-8
===================================================================
diff --git a/Doc/conf.py b/Doc/conf.py
--- a/Doc/conf.py	(revision 8255901127193a0b5e82034e730f7749b68c460f)
+++ b/Doc/conf.py	(revision a93073936f4ea1cd3fa62e0a478b1b3aa1f40a98)
@@ -355,6 +355,7 @@
 \let\Verbatim=\OriginalVerbatim
 \let\endVerbatim=\endOriginalVerbatim
 \setcounter{tocdepth}{2}
+\makeatletter\let\@toodeep\relax\makeatother
 ''',
     # The paper size ('letterpaper' or 'a4paper').
     'papersize': 'a4paper',

I plan to prepare a follow-up PR soon.

[jfbu]

Hi, I guess setting `'maxlistdepth'` to a higher value `'10'` or `'12'` did not help? It would be nice to fetch the actual reported LaTeX error for analysis, if at all possible.

[m-aciek]

Hi, I guess setting 'maxlistdepth' to a higher value '10' or '12' did not help?

I will try it later.

It would be nice to fetch the actual reported LaTeX error for analysis, if at all possible.

The logs are available here: https://github.com/m-aciek/python-docs-offline/actions/runs/22630330823. There is pdf-logs.zip artifact with .tex and .log files.

[jfbu]

In reference.log:

[73]

! LaTeX Error: Too deeply nested.

See the LaTeX manual or LaTeX Companion for explanation.
Type  H <return>  for immediate help.
 ...                                              
                                                  
l.8582 \begin{DUlineblock}{\DUlineblockindent}
                                              
You're in trouble here.  Try typing  <return>  to proceed.
If that doesn't work, type  X <return>  to quit.

[74] [75] [76

Try increasing the setting of 'maxlistdepth'.

[m-aciek]

I am sorry for confusion, I was wrong! I was working on an old checkout from repository 🤦 and didn't have above changes locally. Sorry for the noise, and thank you for the help @jfbu!

[jfbu]

no problem, glad you could figure it out!