ghc-9.4 manual fails to build with sphinx 6
Summary
I tried to build ghc-9.4.5 for Fedora Rawhide and building the ghc manual with sphinx-6.1.3 fails.
It seems sphinx was updated from 5.3 to 6.1 last week in Fedora Rawhide (for Fedora 39).
Steps to reproduce
See https://koji.fedoraproject.org/koji/getfile?taskID=100178957&name=build.log :
:
# ghc-pkg (for binary-dist-dir)
| Remove file _build/bindist/ghc-9.4.5-aarch64-unknown-linux/lib/settings
| Run Sphinx HtmlMode: utils/haddock/doc => _build/doc/html/Haddock
| Create directory _build/stage1/haddock-timing-files
| Run Haddock BuildPackage: libraries/ghc-prim/GHC/CString.hs (and 12 more) => _build/doc/html/libraries/ghc-prim-0.9.0/ghc-prim.haddock
| Run Sphinx HtmlMode: docs/users_guide => _build/doc/html/users_guide
Command line: /usr/bin/sphinx-build -b html -d _build/doc/html/users_guide/.doctrees-html -n -w _build/doc/html/users_guide/.log docs/users_guide _build/doc/html/users_guide
===> Command failed with error code: 2
Exception occurred:
File "/usr/lib/python3.11/site-packages/sphinx/ext/extlinks.py", line 103, in role
title = caption % part
~~~~~~~~^~~~~~
TypeError: not all arguments converted during string formatting
The full traceback has been saved in /tmp/sphinx-err-3tc2mj2k.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!
Running Sphinx v6.1.3
building [mo]: targets for 0 po files that are out of date
writing output...
building [html]: targets for 159 source files that are out of date
updating environment: [new config] 159 added, 0 changed, 0 removed
reading sources... [ 0%] 9.4.1-notes
Command failed
Build failed.
The spec is here: https://src.fedoraproject.org/rpms/ghc9.4/blob/rawhide/f/ghc9.4.spec
Going to test with ghc9.6 too, though I suspect all current ghc versions are likely affected.
Expected behavior
Build successfully.
Environment
- GHC version used: ghc-9.4.5
Optional:
- Operating System: Fedora Linux Rawhide
- System Architecture: x86_64
For now I will probably just disable the manual for Fedora 39.