[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