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 <[email protected]>
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

_______________________________________________
cfe-commits mailing list
[email protected]
https://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-commits

Reply via email to