[clang] [analyzer][docs] Fix invalid MyST toctree 'numbered' option after Markdown migration (PR #207217)
Balázs Benics via cfe-commits
cfe-commits at lists.llvm.org
Thu Jul 2 09:13:18 PDT 2026
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 <benicsbalazs at gmail.com>
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/*
```
More information about the cfe-commits
mailing list