https://github.com/steakhal created https://github.com/llvm/llvm-project/pull/207217
The RST-to-Markdown migration (#206181) converted the RST flag `:numbered:` into `:numbered: true`. MyST parses the toctree `numbered` option as `int_or_nothing`, so the string `true` fails with: ``` 'toctree': Invalid option value for 'numbered': true: invalid literal for int() with base 10: 'true' ``` This breaks the `-W` (warnings-as-errors) `docs-clang-html` build. Make `numbered` a valueless flag, which MyST accepts (equivalent to the original RST behavior of numbering all levels). Assisted-By: claude From 063ef5793dbf938cfb224af1dcbb3d82b510c3ed Mon Sep 17 00:00:00 2001 From: Balazs Benics <[email protected]> Date: Thu, 2 Jul 2026 13:11:22 +0100 Subject: [PATCH] [analyzer][docs] Fix invalid MyST toctree 'numbered' option after Markdown migration The RST-to-Markdown migration (#206181) converted the RST flag `:numbered:` into `:numbered: true`. MyST parses the toctree `numbered` option as `int_or_nothing`, so the string `true` fails with: ``` 'toctree': Invalid option value for 'numbered': true: invalid literal for int() with base 10: 'true' ``` This breaks the `-W` (warnings-as-errors) `docs-clang-html` build. Make `numbered` a valueless flag, which MyST accepts (equivalent to the original RST behavior of numbering all levels). Assisted-By: claude --- clang/docs/ClangStaticAnalyzer.md | 2 +- clang/docs/ScalableStaticAnalysis/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/clang/docs/ClangStaticAnalyzer.md b/clang/docs/ClangStaticAnalyzer.md index 0172c6f4a5e9d..edb76249a9f8a 100644 --- a/clang/docs/ClangStaticAnalyzer.md +++ b/clang/docs/ClangStaticAnalyzer.md @@ -10,7 +10,7 @@ This is the documentation page of the Static Analyzer; there is also an old [Off ```{toctree} :caption: Table of Contents :maxdepth: 2 -:numbered: true +:numbered: analyzer/checkers analyzer/user-docs diff --git a/clang/docs/ScalableStaticAnalysis/index.md b/clang/docs/ScalableStaticAnalysis/index.md index 841fbb1bd3bc5..37cebb69d06a2 100644 --- a/clang/docs/ScalableStaticAnalysis/index.md +++ b/clang/docs/ScalableStaticAnalysis/index.md @@ -5,7 +5,7 @@ This is a framework for writing cross-translation unit analyses in a scalable an ```{toctree} :glob: true :maxdepth: 2 -:numbered: true +:numbered: user-docs/* ``` _______________________________________________ cfe-commits mailing list [email protected] https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits
