ghc 9.4/9.6 documentation build fails with Sphinx 7.0.x
Summary
build of docu with Sphinx 7.0.1 fails because https://github.com/sphinx-doc/sphinx/pull/11381
Steps to reproduce
_build/bin/hadrian --flavour=perf --docs=no-sphinx-pdfs --docs=no-sphinx-man binary-dist-dir
Expected behavior
What do you expect the reproducer described above to do?
Succcesfully build ghc with docs
Environment
- GHC version used: 9.4.5 and 9.6.1
Optional:
- Operating System: openSUSE Tumbleweed (Linux)
- System Architecture: x86_64, ppc64le, aarch64, s390x
Log:
[11937s] Emphasis, Bold and Monospaced styled Text
[11937s] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[11937s] | Run Tar Create: _build/doc/html/Haddock => _build/doc/archives/Haddock.html.tar.xz
[11949s] | Create directory _build/stage1/haddock-timing-files
[11949s] | Run Haddock BuildPackage: libraries/ghc-bignum/src/GHC/Num/Backend.hs (and 8 more) => _build/doc/html/libraries/ghc-bignum-1.3/ghc-bignum.haddock
[11951s] 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
[11951s] ===> Command failed with error code: 2
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/9.4.5-notes.rst:47: WARNING: Bullet list ends without a blank line; unexpected unindent.
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/9.4.5-notes.rst:67: ERROR: Unexpected indentation.
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/9.4.5-notes.rst:88: ERROR: Unknown interpreted text role "ghc-ticet".
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/phases.rst:345: WARNING: duplicate ghc-flag description of -Uâ¨symbolâŠ, other instance in phases
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/phases.rst:609: WARNING: duplicate ghc-flag description of -fllvm, other instance in phases
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/phases.rst:1319: WARNING: duplicate ghc-flag description of -no-pie, other instance in phases
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/runtime_control.rst:1179: WARNING: duplicate rts-flag description of -hT, other instance in profiling
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/runtime_control.rst:1179: WARNING: duplicate rts-flag description of -h, other instance in profiling
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/runtime_control.rst:1391: WARNING: duplicate rts-flag description of -xc, other instance in profiling
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/using.rst:348: WARNING: duplicate ghc-flag description of -c, other instance in phases
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/using.rst:392: WARNING: duplicate ghc-flag description of -shared, other instance in phases
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/using.rst:412: WARNING: duplicate ghc-flag description of --show-iface â¨fileâŠ, other instance in separate_compilation
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/using-warnings.rst:167: WARNING: duplicate ghc-flag description of -Wno-compat, other instance in using-warnings
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/using-warnings.rst:175: WARNING: duplicate ghc-flag description of -w, other instance in using-warnings
[11951s] /home/abuild/rpmbuild/BUILD/ghc-9.4.5/docs/users_guide/using-warnings.rst:220: WARNING: duplicate ghc-flag description of -Wwarn, other instance in using-warnings
[11951s]
[11951s] Theme error:
[11951s] An error happened in rendering the page 9.4.1-notes.
[11951s] Reason: UndefinedError("'style' is undefined")
[11951s] Running Sphinx v7.0.1
[11951s] building [mo]: targets for 0 po files that are out of date
[11951s] writing output...
[11951s] building [html]: targets for 159 source files that are out of date
[11951s] updating environment: [new config] 159 added, 0 changed, 0 removed
[11951s] reading sources... [ 0%] 9.4.1-notes
[11951s] reading sources... [ 1%] 9.4.2-notes
[11951s] reading sources... [ 1%] 9.4.3-notes
[11951s] reading sources... [ 2%] 9.4.4-notes
[11951s] reading sources... [ 3%] 9.4.5-notes
[11951s] reading sources... [ 3%] bugs
[11951s] reading sources... [ 4%] codegens
[11951s] reading sources... [ 5%] debug-info
[11951s] reading sources... [ 5%] debugging
[11951s] reading sources... [ 6%] editing-guide
[11951s] reading sources... [ 6%] eventlog-formats
[11951s] reading sources... [ 7%] extending_ghc
[11951s] reading sources... [ 8%] exts
[11951s] reading sources... [ 8%] exts/ambiguous_types
[11951s] reading sources... [ 9%] exts/applicative_do
[11951s] reading sources... [ 10%] exts/arrows
[11951s] reading sources... [ 10%] exts/assert
[11951s] reading sources... [ 11%] exts/binary_literals
[11951s] reading sources... [ 11%] exts/bindings
[11951s] reading sources... [ 12%] exts/block_arguments
[11951s] reading sources... [ 13%] exts/callstack
[11951s] reading sources... [ 13%] exts/concurrent
[11951s] reading sources... [ 14%] exts/constrained_class_methods
[11951s] reading sources... [ 15%] exts/constraint_kind
[11951s] reading sources... [ 15%] exts/constraints
[11951s] reading sources... [ 16%] exts/control
[11951s] reading sources... [ 16%] exts/data_kinds
[11951s] reading sources... [ 17%] exts/datatype_contexts
[11951s] reading sources... [ 18%] exts/default_signatures
[11951s] reading sources... [ 18%] exts/defer_type_errors
[11951s] reading sources... [ 19%] exts/derive_any_class
[11951s] reading sources... [ 20%] exts/deriving
[11951s] reading sources... [ 20%] exts/deriving_extra
[11951s] reading sources... [ 21%] exts/deriving_inferred
[11951s] reading sources... [ 22%] exts/deriving_strategies
[11951s] reading sources... [ 22%] exts/deriving_via
[11951s] reading sources... [ 23%] exts/disambiguate_record_fields
[11951s] reading sources... [ 23%] exts/duplicate_record_fields
[11951s] reading sources... [ 24%] exts/empty_case
[11951s] reading sources... [ 25%] exts/empty_data_deriving
[11951s] reading sources... [ 25%] exts/equality_constraints
[11951s] reading sources... [ 26%] exts/existential_quantification
[11951s] reading sources... [ 27%] exts/explicit_forall
[11951s] reading sources... [ 27%] exts/explicit_namespaces
[11951s] reading sources... [ 28%] exts/ffi
[11951s] reading sources... [ 28%] exts/field_selectors
[11951s] reading sources... [ 29%] exts/field_selectors_and_type_applications
[11951s] reading sources... [ 30%] exts/flexible_contexts
[11951s] reading sources... [ 30%] exts/functional_dependencies
[11951s] reading sources... [ 31%] exts/gadt
[11951s] reading sources... [ 32%] exts/gadt_syntax
[11951s] reading sources... [ 32%] exts/generalised_list_comprehensions
[11951s] reading sources... [ 33%] exts/generics
[11951s] reading sources... [ 33%] exts/hasfield
[11951s] reading sources... [ 34%] exts/hex_float_literals
[11951s] reading sources... [ 35%] exts/hiding_unexported
[11951s] reading sources... [ 35%] exts/implicit_parameters
[11951s] reading sources... [ 36%] exts/import_export
[11951s] reading sources... [ 37%] exts/import_qualified_post
[11951s] reading sources... [ 37%] exts/impredicative_types
[11951s] reading sources... [ 38%] exts/infix_tycons
[11951s] reading sources... [ 38%] exts/instances
[11951s] reading sources... [ 39%] exts/intro
[11951s] reading sources... [ 40%] exts/kind_signatures
[11951s] reading sources... [ 40%] exts/lambda_case
[11951s] reading sources... [ 41%] exts/let_generalisation
[11951s] reading sources... [ 42%] exts/lexical_negation
[11951s] reading sources... [ 42%] exts/liberal_type_synonyms
[11951s] reading sources... [ 43%] exts/linear_types
[11951s] reading sources... [ 44%] exts/literals
[11951s] reading sources... [ 44%] exts/local_fixity_decls
[11951s] reading sources... [ 45%] exts/magic_hash
[11951s] reading sources... [ 45%] exts/misc
[11951s] reading sources... [ 46%] exts/monad_comprehensions
[11951s] reading sources... [ 47%] exts/monomorphism
[11951s] reading sources... [ 47%] exts/multi_param_type_classes
[11951s] reading sources... [ 48%] exts/multiway_if
[11951s] reading sources... [ 49%] exts/negative_literals
[11951s] reading sources... [ 49%] exts/newtype_deriving
[11951s] reading sources... [ 50%] exts/nk_patterns
[11951s] reading sources... [ 50%] exts/nullary_type_classes
[11951s] reading sources... [ 51%] exts/nullary_types
[11951s] reading sources... [ 52%] exts/num_decimals
[11951s] reading sources... [ 52%] exts/numeric_underscores
[11951s] reading sources... [ 53%] exts/overloaded_labels
[11951s] reading sources... [ 54%] exts/overloaded_lists
[11951s] reading sources... [ 54%] exts/overloaded_record_dot
[11951s] reading sources... [ 55%] exts/overloaded_record_update
[11951s] reading sources... [ 55%] exts/overloaded_strings
[11951s] reading sources... [ 56%] exts/package_qualified_imports
[11951s] reading sources... [ 57%] exts/parallel
[11951s] reading sources... [ 57%] exts/parallel_list_comprehensions
[11951s] reading sources... [ 58%] exts/partial_type_signatures
[11951s] reading sources... [ 59%] exts/pattern_guards
[11951s] reading sources... [ 59%] exts/pattern_synonyms
[11951s] reading sources... [ 60%] exts/patterns
[11951s] reading sources... [ 61%] exts/poly_kinds
[11951s] reading sources... [ 61%] exts/pragmas
[11951s] reading sources... [ 62%] exts/primitives
[11951s] reading sources... [ 62%] exts/qualified_do
[11951s] reading sources... [ 63%] exts/quantified_constraints
[11951s] reading sources... [ 64%] exts/rank_polymorphism
[11951s] reading sources... [ 64%] exts/rebindable_syntax
[11951s] reading sources... [ 65%] exts/record_puns
[11951s] reading sources... [ 66%] exts/record_wildcards
[11951s] reading sources... [ 66%] exts/records
[11951s] reading sources... [ 67%] exts/recursive_do
[11951s] reading sources... [ 67%] exts/representation_polymorphism
[11951s] reading sources... [ 68%] exts/rewrite_rules
[11951s] reading sources... [ 69%] exts/roles
[11951s] reading sources... [ 69%] exts/safe_haskell
[11951s] reading sources... [ 70%] exts/safe_imports
[11951s] reading sources... [ 71%] exts/scoped_type_variables
[11951s] reading sources... [ 71%] exts/special_builtin
[11951s] reading sources... [ 72%] exts/standalone_deriving
[11951s] reading sources... [ 72%] exts/static_pointers
[11951s] reading sources... [ 73%] exts/stm
[11951s] reading sources... [ 74%] exts/stolen_syntax
[11951s] reading sources... [ 74%] exts/strict
[11951s] reading sources... [ 75%] exts/syntax
[11951s] reading sources... [ 76%] exts/table
[11951s] reading sources... [ 76%] exts/template_haskell
[11951s] reading sources... [ 77%] exts/traditional_record_syntax
[11951s] reading sources... [ 77%] exts/tuple_sections
[11951s] reading sources... [ 78%] exts/type_applications
[11951s] reading sources... [ 79%] exts/type_errors
[11951s] reading sources... [ 79%] exts/type_families
[11951s] reading sources... [ 80%] exts/type_literals
[11951s] reading sources... [ 81%] exts/type_operators
[11951s] reading sources... [ 81%] exts/type_signatures
[11951s] reading sources... [ 82%] exts/typeclasses
[11951s] reading sources... [ 83%] exts/typed_holes
[11951s] reading sources... [ 83%] exts/types
[11951s] reading sources... [ 84%] exts/undecidable_super_classes
[11951s] reading sources... [ 84%] exts/unicode_syntax
[11951s] reading sources... [ 85%] exts/view_patterns
[11951s] reading sources... [ 86%] flags
[11951s] reading sources... [ 86%] ghc
[11951s] reading sources... [ 87%] ghci
[11951s] reading sources... [ 88%] gone_wrong
[11951s] reading sources... [ 88%] hints
[11951s] reading sources... [ 89%] index
[11951s] reading sources... [ 89%] intro
[11951s] reading sources... [ 90%] packages
[11951s] reading sources... [ 91%] phases
[11951s] reading sources... [ 91%] profiling
[11951s] reading sources... [ 92%] release-notes
[11951s] reading sources... [ 93%] runghc
[11951s] reading sources... [ 93%] runtime_control
[11951s] reading sources... [ 94%] separate_compilation
[11951s] reading sources... [ 94%] shared_libs
[11951s] reading sources... [ 95%] usage
[11951s] reading sources... [ 96%] using
[11951s] reading sources... [ 96%] using-concurrent
[11951s] reading sources... [ 97%] using-optimisation
[11951s] reading sources... [ 98%] using-warnings
[11951s] reading sources... [ 98%] utils
[11951s] reading sources... [ 99%] what_glasgow_exts_does
[11951s] reading sources... [100%] win32-dlls
[11951s]
[11951s] looking for now-outdated files... none found
[11951s] pickling environment... done
[11951s] checking consistency... done
[11951s] preparing documents... done
[11951s] writing output... [ 0%] 9.4.1-notes
[11951s] Command failed
[11951s] Build failed.
same error with 9.6.1-notes