[clang] [clang][CIR][docs] Fix invalid MyST toctree 'numbered' option (PR #213898)
Balázs Benics via cfe-commits
cfe-commits at lists.llvm.org
Tue Aug 4 03:32:32 PDT 2026
https://github.com/steakhal created https://github.com/llvm/llvm-project/pull/213898
Similar to #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).
>From bebd42f478bc8289f50983b1ce1e72d2f6757698 Mon Sep 17 00:00:00 2001
From: Balazs Benics <benicsbalazs at gmail.com>
Date: Tue, 4 Aug 2026 11:29:11 +0100
Subject: [PATCH] [clang][CIR][docs] Fix invalid MyST toctree 'numbered' option
Similar to #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).
---
clang/docs/CIR/index.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/clang/docs/CIR/index.md b/clang/docs/CIR/index.md
index a594ac50dbf67..a418c4ae5caa9 100644
--- a/clang/docs/CIR/index.md
+++ b/clang/docs/CIR/index.md
@@ -14,7 +14,7 @@ a position between Clang's AST and LLVM IR.
```{toctree}
:maxdepth: 1
-:numbered: true
+:numbered:
ABILowering
CleanupAndEHDesign
More information about the cfe-commits
mailing list