[llvm] [Docs] Reland Furo theme for LLVM docs (PR #211993)

Sat Jul 25 00:12:57 PDT 2026

llvmorg-github-actions[bot] wrote:




@llvm/pr-subscribers-backend-risc-v

Author: Anshul Nigham (nigham)

<details>
<summary>Changes</summary>

Relands https://github.com/llvm/llvm-project/pull/184440 which was reverted in https://github.com/llvm/llvm-project/pull/208619 because of doc generation slowness.

The main root cause (https://github.com/llvm/llvm-project/issues/208786) has been addressed, so attempting a reland at this point.

As before, Furo output at https://nigham.github.io/llvm_docs_furo/LangRef.html

---

Patch is 64.42 KiB, truncated to 20.00 KiB below, full version: https://github.com/llvm/llvm-project/pull/211993.diff


168 Files Affected:

- (modified) llvm/docs/AArch64SME.md (-3) 
- (modified) llvm/docs/AMDGPU/DeveloperGuideline.rst (-2) 
- (modified) llvm/docs/AMDGPUAsyncOperations.md (-3) 
- (modified) llvm/docs/AMDGPUDMAOperations.md (-3) 
- (modified) llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md (-5) 
- (modified) llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst (-2) 
- (modified) llvm/docs/AMDGPUExecutionSynchronization.md (-3) 
- (modified) llvm/docs/AMDGPUInstructionNotation.rst (-2) 
- (modified) llvm/docs/AMDGPUInstructionSyntax.rst (-2) 
- (modified) llvm/docs/AMDGPUMemoryModel.md (-3) 
- (modified) llvm/docs/AMDGPUModifierSyntax.rst (-2) 
- (modified) llvm/docs/AMDGPUOperandSyntax.rst (-2) 
- (modified) llvm/docs/AMDGPUUsage.rst (-2) 
- (modified) llvm/docs/AddingConstrainedIntrinsics.md (-3) 
- (modified) llvm/docs/AdvancedBuilds.md (-3) 
- (modified) llvm/docs/AliasAnalysis.md (-3) 
- (modified) llvm/docs/Atomics.md (-3) 
- (modified) llvm/docs/BigEndianNEON.md (-3) 
- (modified) llvm/docs/BitCodeFormat.md (-4) 
- (modified) llvm/docs/BlockFrequencyTerminology.rst (-2) 
- (modified) llvm/docs/BranchWeightMetadata.rst (-2) 
- (modified) llvm/docs/BugLifeCycle.rst (-2) 
- (modified) llvm/docs/BuildingADistribution.md (-3) 
- (modified) llvm/docs/CFIVerify.md (-3) 
- (modified) llvm/docs/CMake.md (-3) 
- (modified) llvm/docs/CMakePrimer.rst (-2) 
- (modified) llvm/docs/CodeGenerator.md (-3) 
- (modified) llvm/docs/CodingStandards.md (-3) 
- (modified) llvm/docs/CommandGuide/llvm-debuginfo-analyzer.rst (-2) 
- (modified) llvm/docs/CommandGuide/llvm-pdbutil.rst (-2) 
- (modified) llvm/docs/CommandLine.md (-3) 
- (modified) llvm/docs/CompileCudaWithLLVM.md (-3) 
- (modified) llvm/docs/CompilerWriterInfo.md (-3) 
- (modified) llvm/docs/Contributing.md (-3) 
- (modified) llvm/docs/ConvergenceAndUniformity.rst (-2) 
- (modified) llvm/docs/ConvergentOperations.rst (-3) 
- (modified) llvm/docs/Coroutines.md (-4) 
- (modified) llvm/docs/CoverageMappingFormat.md (-3) 
- (modified) llvm/docs/CycleTerminology.md (-3) 
- (modified) llvm/docs/DTLTO.md (-4) 
- (modified) llvm/docs/DependenceGraphs/index.rst (-2) 
- (modified) llvm/docs/DeveloperPolicy.md (-3) 
- (modified) llvm/docs/DirectX/DXContainer.rst (-2) 
- (modified) llvm/docs/DirectX/DXILArchitecture.rst (-2) 
- (modified) llvm/docs/DirectX/DXILOpTableGenDesign.rst (-2) 
- (modified) llvm/docs/DirectX/DXILResources.rst (-2) 
- (modified) llvm/docs/DirectX/RootSignatures.rst (-2) 
- (modified) llvm/docs/DirectXUsage.rst (-2) 
- (modified) llvm/docs/ExceptionHandling.md (-3) 
- (modified) llvm/docs/Extensions.md (-3) 
- (modified) llvm/docs/FAQ.md (-3) 
- (modified) llvm/docs/FatLTO.rst (-3) 
- (modified) llvm/docs/FaultMaps.rst (-3) 
- (modified) llvm/docs/Frontend/PerformanceTips.md (-4) 
- (modified) llvm/docs/FuzzingLLVM.rst (-3) 
- (modified) llvm/docs/GarbageCollection.md (-3) 
- (modified) llvm/docs/GetElementPtr.rst (-2) 
- (modified) llvm/docs/GettingInvolved.md (-3) 
- (modified) llvm/docs/GettingStarted.md (-3) 
- (modified) llvm/docs/GettingStartedVS.md (-3) 
- (modified) llvm/docs/GitHub.md (-3) 
- (modified) llvm/docs/GlobalISel/GMIR.rst (-2) 
- (modified) llvm/docs/GlobalISel/GenericOpcode.rst (-2) 
- (modified) llvm/docs/GlobalISel/IRTranslator.rst (-2) 
- (modified) llvm/docs/GlobalISel/MIRPatterns.rst (-2) 
- (modified) llvm/docs/GlobalISel/index.rst (-3) 
- (modified) llvm/docs/GwpAsan.rst (-3) 
- (modified) llvm/docs/HowToReleaseLLVM.rst (-2) 
- (modified) llvm/docs/HowToSetUpLLVMStyleRTTI.rst (-1) 
- (modified) llvm/docs/HowToUpdateDebugInfo.md (-3) 
- (modified) llvm/docs/HowToUseAttributes.rst (-2) 
- (modified) llvm/docs/HowToUseInstrMappings.rst (-2) 
- (modified) llvm/docs/InstCombineContributorGuide.md (-3) 
- (modified) llvm/docs/InstrProfileFormat.md (-3) 
- (modified) llvm/docs/Instrumentor.md (-3) 
- (modified) llvm/docs/JITLink.md (-3) 
- (modified) llvm/docs/KernelInfo.rst (-2) 
- (modified) llvm/docs/LFI.rst (-2) 
- (modified) llvm/docs/LangRef.md (+4-4) 
- (modified) llvm/docs/LibFuzzer.md (-16) 
- (modified) llvm/docs/LinkTimeOptimization.md (-3) 
- (modified) llvm/docs/LoopTerminology.md (-3) 
- (modified) llvm/docs/MIRLangRef.md (-3) 
- (modified) llvm/docs/MLGO.rst (-1) 
- (modified) llvm/docs/MarkedUpDisassembly.rst (-2) 
- (modified) llvm/docs/MemProf.md (-4) 
- (modified) llvm/docs/MemTagSanitizer.rst (-2) 
- (modified) llvm/docs/MemoryModelRelaxationAnnotations.rst (-2) 
- (modified) llvm/docs/MemorySSA.md (-3) 
- (modified) llvm/docs/MergeFunctions.md (-3) 
- (modified) llvm/docs/MisExpect.rst (-1) 
- (modified) llvm/docs/MyFirstTypoFix.md (-3) 
- (modified) llvm/docs/NVPTXUsage.md (-4) 
- (modified) llvm/docs/NewPassManager.md (-3) 
- (modified) llvm/docs/ORCv2.md (-3) 
- (modified) llvm/docs/OptBisect.rst (-3) 
- (modified) llvm/docs/PCSectionsMetadata.rst (-2) 
- (modified) llvm/docs/PDB/CodeViewSymbols.rst (-2) 
- (modified) llvm/docs/PDB/CodeViewTypes.rst (-2) 
- (modified) llvm/docs/PDB/DbiStream.rst (-2) 
- (modified) llvm/docs/PDB/HashTable.rst (-2) 
- (modified) llvm/docs/PDB/ModiStream.rst (-2) 
- (modified) llvm/docs/PDB/MsfFile.rst (-2) 
- (modified) llvm/docs/PDB/PdbStream.rst (-2) 
- (modified) llvm/docs/PDB/TpiStream.rst (-2) 
- (modified) llvm/docs/PDB/index.rst (-2) 
- (modified) llvm/docs/Passes.md (-3) 
- (modified) llvm/docs/ProgrammersManual.md (-3) 
- (modified) llvm/docs/ProjectGovernance.md (-3) 
- (modified) llvm/docs/Projects.rst (-2) 
- (modified) llvm/docs/Proposals/GitHubMove.rst (-3) 
- (modified) llvm/docs/Proposals/TestSuite.rst (-3) 
- (modified) llvm/docs/Proposals/VariableNames.rst (-2) 
- (modified) llvm/docs/Proposals/VectorPredication.rst (-3) 
- (modified) llvm/docs/RFCProcess.md (-4) 
- (modified) llvm/docs/RISCV/RISCVVCIX.rst (-2) 
- (modified) llvm/docs/RISCV/RISCVVectorExtension.rst (-2) 
- (modified) llvm/docs/RISCVUsage.rst (-2) 
- (modified) llvm/docs/Reference.md (-3) 
- (modified) llvm/docs/ReleaseNotes.md (-2) 
- (modified) llvm/docs/ReleaseProcess.rst (-11) 
- (modified) llvm/docs/Remarks.md (-3) 
- (modified) llvm/docs/SPIRVUsage.md (-3) 
- (modified) llvm/docs/SandboxVectorizer.md (-3) 
- (modified) llvm/docs/ScudoHardenedAllocator.rst (-3) 
- (modified) llvm/docs/SegmentedStacks.rst (-2) 
- (modified) llvm/docs/SourceLevelDebugging.md (-3) 
- (modified) llvm/docs/SphinxQuickstartTemplate.md (-3) 
- (modified) llvm/docs/StackMaps.rst (-3) 
- (modified) llvm/docs/Statepoints.rst (-3) 
- (modified) llvm/docs/SymbolizerMarkupFormat.rst (-2) 
- (modified) llvm/docs/TableGen/BackEnds.rst (-2) 
- (modified) llvm/docs/TableGen/BackGuide.rst (-2) 
- (modified) llvm/docs/TableGen/ProgRef.rst (-2) 
- (modified) llvm/docs/TableGen/index.md (-3) 
- (modified) llvm/docs/Telemetry.rst (-2) 
- (modified) llvm/docs/TestingGuide.md (-3) 
- (modified) llvm/docs/TransformMetadata.rst (-2) 
- (modified) llvm/docs/UndefinedBehavior.rst (-3) 
- (modified) llvm/docs/UserGuides.md (-3) 
- (modified) llvm/docs/VectorizationPlan.rst (-2) 
- (modified) llvm/docs/Vectorizers.md (-3) 
- (modified) llvm/docs/WritingAnLLVMBackend.md (-3) 
- (modified) llvm/docs/WritingAnLLVMNewPMPass.md (-3) 
- (modified) llvm/docs/WritingAnLLVMPass.md (-3) 
- (modified) llvm/docs/XRay.rst (-2) 
- (modified) llvm/docs/XRayExample.rst (-2) 
- (modified) llvm/docs/XRayFDRFormat.rst (-2) 
- (modified) llvm/docs/YamlIO.rst (-2) 
- (added) llvm/docs/_static/LLVMWyvernSmall.png () 
- (added) llvm/docs/_static/copybutton.css (+39) 
- (added) llvm/docs/_static/copybutton.js (+56) 
- (added) llvm/docs/_static/custom.css (+62) 
- (modified) llvm/docs/conf.py (+16-15) 
- (modified) llvm/docs/tutorial/BuildingAJIT1.rst (-2) 
- (modified) llvm/docs/tutorial/BuildingAJIT2.rst (-2) 
- (modified) llvm/docs/tutorial/BuildingAJIT3.rst (-2) 
- (modified) llvm/docs/tutorial/BuildingAJIT4.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl01.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl02.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl03.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl04.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl05.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl06.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl07.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl08.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl09.rst (-2) 
- (modified) llvm/docs/tutorial/MyFirstLanguageFrontend/LangImpl10.rst (-2) 


``````````diff

diff --git a/llvm/docs/AArch64SME.md b/llvm/docs/AArch64SME.md
index 24292559f2f1c..877740e3d0c85 100644
--- a/llvm/docs/AArch64SME.md
+++ b/llvm/docs/AArch64SME.md
@@ -1,8 +1,5 @@
 # Support for AArch64 Scalable Matrix Extension in LLVM
 
-```{contents}
-:local: true
-```
 
 ## 1. Introduction
 
diff --git a/llvm/docs/AMDGPU/DeveloperGuideline.rst b/llvm/docs/AMDGPU/DeveloperGuideline.rst
index 97b7e82f44288..c2fb5f58b6715 100644
--- a/llvm/docs/AMDGPU/DeveloperGuideline.rst
+++ b/llvm/docs/AMDGPU/DeveloperGuideline.rst
@@ -2,8 +2,6 @@
 Developer Guideline for AMDGPU
 ===============================
 
-.. contents::
-   :local:
 
 Introduction
 ============
diff --git a/llvm/docs/AMDGPUAsyncOperations.md b/llvm/docs/AMDGPUAsyncOperations.md
index 1863a516fdd19..08db935a60dd2 100644
--- a/llvm/docs/AMDGPUAsyncOperations.md
+++ b/llvm/docs/AMDGPUAsyncOperations.md
@@ -2,9 +2,6 @@
 
 # AMDGPU Asynchronous Operations
 
-```{contents}
-:local: true
-```
 
 ## Introduction
 
diff --git a/llvm/docs/AMDGPUDMAOperations.md b/llvm/docs/AMDGPUDMAOperations.md
index ef83cb361897c..ffd6201e8e27e 100644
--- a/llvm/docs/AMDGPUDMAOperations.md
+++ b/llvm/docs/AMDGPUDMAOperations.md
@@ -2,9 +2,6 @@
 
 # AMDGPU DMA Operations
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md b/llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md
index e06c7ef80a09e..f017672907a48 100644
--- a/llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md
+++ b/llvm/docs/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack/AMDGPUDwarfExtensionAllowLocationDescriptionOnTheDwarfExpressionStack.md
@@ -1,10 +1,5 @@
 # Allow Location Descriptions on the DWARF Expression Stack <!-- omit in toc -->
 
-```{contents}
----
-local:
----
-```
 
 ## 1. Extension
 
diff --git a/llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst b/llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst
index 933f6dd72723c..ad4010c46de84 100644
--- a/llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst
+++ b/llvm/docs/AMDGPUDwarfExtensionsForHeterogeneousDebugging.rst
@@ -4,8 +4,6 @@
 DWARF Extensions For Heterogeneous Debugging
 ********************************************
 
-.. contents::
-   :local:
 
 .. warning::
 
diff --git a/llvm/docs/AMDGPUExecutionSynchronization.md b/llvm/docs/AMDGPUExecutionSynchronization.md
index 09c8bc602f8b9..8dfb51520ad48 100644
--- a/llvm/docs/AMDGPUExecutionSynchronization.md
+++ b/llvm/docs/AMDGPUExecutionSynchronization.md
@@ -2,9 +2,6 @@
 
 # AMDGPU Execution Synchronization
 
-```{contents}
-:local: true
-```
 
 (amdgpu-execution-synchronization-barriers)=
 
diff --git a/llvm/docs/AMDGPUInstructionNotation.rst b/llvm/docs/AMDGPUInstructionNotation.rst
index 42e0c16235f4a..7244d47f80528 100644
--- a/llvm/docs/AMDGPUInstructionNotation.rst
+++ b/llvm/docs/AMDGPUInstructionNotation.rst
@@ -2,8 +2,6 @@
 AMDGPU Instructions Notation
 ============================
 
-.. contents::
-   :local:
 
 .. _amdgpu_syn_instruction_notation:
 
diff --git a/llvm/docs/AMDGPUInstructionSyntax.rst b/llvm/docs/AMDGPUInstructionSyntax.rst
index 38669a3c8d3e8..831fc7fd0faf5 100644
--- a/llvm/docs/AMDGPUInstructionSyntax.rst
+++ b/llvm/docs/AMDGPUInstructionSyntax.rst
@@ -2,8 +2,6 @@
 AMDGPU Instruction Syntax
 =========================
 
-.. contents::
-   :local:
 
 .. _amdgpu_syn_instructions:
 
diff --git a/llvm/docs/AMDGPUMemoryModel.md b/llvm/docs/AMDGPUMemoryModel.md
index 2bba968de6fb1..c057909b0539c 100644
--- a/llvm/docs/AMDGPUMemoryModel.md
+++ b/llvm/docs/AMDGPUMemoryModel.md
@@ -2,9 +2,6 @@
 
 # AMDGPU Memory Model
 
-```{contents}
-:local: true
-```
 
 ## Introduction
 
diff --git a/llvm/docs/AMDGPUModifierSyntax.rst b/llvm/docs/AMDGPUModifierSyntax.rst
index 8404a3e7b308d..c0cc6b8cd7a1c 100644
--- a/llvm/docs/AMDGPUModifierSyntax.rst
+++ b/llvm/docs/AMDGPUModifierSyntax.rst
@@ -2,8 +2,6 @@
 Syntax of AMDGPU Instruction Modifiers
 ======================================
 
-.. contents::
-   :local:
 
 Conventions
 ===========
diff --git a/llvm/docs/AMDGPUOperandSyntax.rst b/llvm/docs/AMDGPUOperandSyntax.rst
index 247a10dd222e4..95bab72fac250 100644
--- a/llvm/docs/AMDGPUOperandSyntax.rst
+++ b/llvm/docs/AMDGPUOperandSyntax.rst
@@ -2,8 +2,6 @@
 Syntax of AMDGPU Instruction Operands
 =====================================
 
-.. contents::
-   :local:
 
 Conventions
 ===========
diff --git a/llvm/docs/AMDGPUUsage.rst b/llvm/docs/AMDGPUUsage.rst
index 552877255842b..443dd7f9772d7 100644
--- a/llvm/docs/AMDGPUUsage.rst
+++ b/llvm/docs/AMDGPUUsage.rst
@@ -4,8 +4,6 @@
 User Guide for AMDGPU Backend
 =============================
 
-.. contents::
-   :local:
 
 .. toctree::
    :hidden:
diff --git a/llvm/docs/AddingConstrainedIntrinsics.md b/llvm/docs/AddingConstrainedIntrinsics.md
index 2f243dd7ae514..4167f35081397 100644
--- a/llvm/docs/AddingConstrainedIntrinsics.md
+++ b/llvm/docs/AddingConstrainedIntrinsics.md
@@ -1,8 +1,5 @@
 # How To Add A Constrained Floating-Point Intrinsic
 
-```{contents}
-:local: true
-```
 
 :::{warning}
 This is a work in progress.
diff --git a/llvm/docs/AdvancedBuilds.md b/llvm/docs/AdvancedBuilds.md
index 42847926dbbdc..39e6362ec0d00 100644
--- a/llvm/docs/AdvancedBuilds.md
+++ b/llvm/docs/AdvancedBuilds.md
@@ -1,8 +1,5 @@
 # Advanced Build Configurations
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/AliasAnalysis.md b/llvm/docs/AliasAnalysis.md
index a5da8817577c0..62b3572dc3d23 100644
--- a/llvm/docs/AliasAnalysis.md
+++ b/llvm/docs/AliasAnalysis.md
@@ -1,8 +1,5 @@
 # LLVM Alias Analysis Infrastructure
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/Atomics.md b/llvm/docs/Atomics.md
index 2be51fbc20d4a..1643dc44b0759 100644
--- a/llvm/docs/Atomics.md
+++ b/llvm/docs/Atomics.md
@@ -6,9 +6,6 @@ myst:
 
 # LLVM Atomic Instructions and Concurrency Guide
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/BigEndianNEON.md b/llvm/docs/BigEndianNEON.md
index 233d0518d5344..b086c50e99812 100644
--- a/llvm/docs/BigEndianNEON.md
+++ b/llvm/docs/BigEndianNEON.md
@@ -5,9 +5,6 @@ myst:
 
 # Using ARM NEON instructions in big-endian mode
 
-```{contents}
-:local: true
-```
 
 ## Introduction
 
diff --git a/llvm/docs/BitCodeFormat.md b/llvm/docs/BitCodeFormat.md
index 5a64b9a2cb5f2..406cd10a0df1f 100644
--- a/llvm/docs/BitCodeFormat.md
+++ b/llvm/docs/BitCodeFormat.md
@@ -1,9 +1,5 @@
 # LLVM Bitcode File Format
 
-```{contents}
-:local:
-
-```
 
 ## Abstract
 
diff --git a/llvm/docs/BlockFrequencyTerminology.rst b/llvm/docs/BlockFrequencyTerminology.rst
index 84e144e922ef6..878a10f35bd62 100644
--- a/llvm/docs/BlockFrequencyTerminology.rst
+++ b/llvm/docs/BlockFrequencyTerminology.rst
@@ -2,8 +2,6 @@
 LLVM Block Frequency Terminology
 ================================
 
-.. contents::
-   :local:
 
 Introduction
 ============
diff --git a/llvm/docs/BranchWeightMetadata.rst b/llvm/docs/BranchWeightMetadata.rst
index adcd17d694e82..02742aa57266c 100644
--- a/llvm/docs/BranchWeightMetadata.rst
+++ b/llvm/docs/BranchWeightMetadata.rst
@@ -2,8 +2,6 @@
 LLVM Branch Weight Metadata
 ===========================
 
-.. contents::
-   :local:
 
 Introduction
 ============
diff --git a/llvm/docs/BugLifeCycle.rst b/llvm/docs/BugLifeCycle.rst
index 1215af9e47e08..5f02f7c550f49 100644
--- a/llvm/docs/BugLifeCycle.rst
+++ b/llvm/docs/BugLifeCycle.rst
@@ -2,8 +2,6 @@
 LLVM Bug Life Cycle
 ===================
 
-.. contents::
-   :local:
 
 
 
diff --git a/llvm/docs/BuildingADistribution.md b/llvm/docs/BuildingADistribution.md
index 680bcf0349a92..e3672e7e26afb 100644
--- a/llvm/docs/BuildingADistribution.md
+++ b/llvm/docs/BuildingADistribution.md
@@ -1,8 +1,5 @@
 # Building a Distribution of LLVM
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/CFIVerify.md b/llvm/docs/CFIVerify.md
index 5968bd7ed3fbe..af396d83cd7a8 100644
--- a/llvm/docs/CFIVerify.md
+++ b/llvm/docs/CFIVerify.md
@@ -1,8 +1,5 @@
 # Control Flow Verification Tool Design Document
 
-```{contents}
-:local:
-```
 
 ## Objective
 
diff --git a/llvm/docs/CMake.md b/llvm/docs/CMake.md
index d97af85057a32..c12c95bbc3dec 100644
--- a/llvm/docs/CMake.md
+++ b/llvm/docs/CMake.md
@@ -1,8 +1,5 @@
 # Building LLVM with CMake
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/CMakePrimer.rst b/llvm/docs/CMakePrimer.rst
index 5d244f443fbaf..ce4604b0d5d5a 100644
--- a/llvm/docs/CMakePrimer.rst
+++ b/llvm/docs/CMakePrimer.rst
@@ -2,8 +2,6 @@
 CMake Primer
 ============
 
-.. contents::
-   :local:
 
 .. warning::
    Disclaimer: This documentation is written by LLVM project contributors `not`
diff --git a/llvm/docs/CodeGenerator.md b/llvm/docs/CodeGenerator.md
index 0dc033d4e5cb6..cd37407de79e4 100644
--- a/llvm/docs/CodeGenerator.md
+++ b/llvm/docs/CodeGenerator.md
@@ -15,9 +15,6 @@
 </style>
 ```
 
-```{contents}
-:local:
-```
 
 ```{warning}
 This is a work in progress.
diff --git a/llvm/docs/CodingStandards.md b/llvm/docs/CodingStandards.md
index 23e8aee3be938..716a959d1cfd2 100644
--- a/llvm/docs/CodingStandards.md
+++ b/llvm/docs/CodingStandards.md
@@ -1,8 +1,5 @@
 # LLVM Coding Standards
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/CommandGuide/llvm-debuginfo-analyzer.rst b/llvm/docs/CommandGuide/llvm-debuginfo-analyzer.rst
index 221732775e74c..3023d48b144dd 100644
--- a/llvm/docs/CommandGuide/llvm-debuginfo-analyzer.rst
+++ b/llvm/docs/CommandGuide/llvm-debuginfo-analyzer.rst
@@ -3,8 +3,6 @@ llvm-debuginfo-analyzer - Print a logical representation of low-level debug info
 
 .. program:: llvm-debuginfo-analyzer
 
-.. contents::
-   :local:
 
 SYNOPSIS
 --------
diff --git a/llvm/docs/CommandGuide/llvm-pdbutil.rst b/llvm/docs/CommandGuide/llvm-pdbutil.rst
index 5f90c4ec958f2..ff00d87e890f1 100644
--- a/llvm/docs/CommandGuide/llvm-pdbutil.rst
+++ b/llvm/docs/CommandGuide/llvm-pdbutil.rst
@@ -3,8 +3,6 @@ llvm-pdbutil - PDB File forensics and diagnostics
 
 .. program:: llvm-pdbutil
 
-.. contents::
-   :local:
 
 Synopsis
 --------
diff --git a/llvm/docs/CommandLine.md b/llvm/docs/CommandLine.md
index 883734e512c04..fab5894acc3df 100644
--- a/llvm/docs/CommandLine.md
+++ b/llvm/docs/CommandLine.md
@@ -1,8 +1,5 @@
 # CommandLine 2.0 Library Manual
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/CompileCudaWithLLVM.md b/llvm/docs/CompileCudaWithLLVM.md
index 8811d1617e319..6372987e1622f 100644
--- a/llvm/docs/CompileCudaWithLLVM.md
+++ b/llvm/docs/CompileCudaWithLLVM.md
@@ -1,8 +1,5 @@
 # Compiling CUDA with clang
 
-```{contents}
-:local: true
-```
 
 ## Introduction
 
diff --git a/llvm/docs/CompilerWriterInfo.md b/llvm/docs/CompilerWriterInfo.md
index d7609a5a325de..a275f604da820 100644
--- a/llvm/docs/CompilerWriterInfo.md
+++ b/llvm/docs/CompilerWriterInfo.md
@@ -1,8 +1,5 @@
 # Architecture & Platform Information for Compiler Writers
 
-```{contents}
-:local:
-```
 
 ```{note}
 This document is a work-in-progress.  Additions and clarifications are
diff --git a/llvm/docs/Contributing.md b/llvm/docs/Contributing.md
index 3dba6cdc22fed..e87cc7896d565 100644
--- a/llvm/docs/Contributing.md
+++ b/llvm/docs/Contributing.md
@@ -8,9 +8,6 @@ you can either use the [Forum] or, for a more interactive chat, go to our
 
 If you want to contribute code, please familiarize yourself with the {doc}`DeveloperPolicy`.
 
-```{contents}
-:local:
-```
 
 
 ## Ways to Contribute
diff --git a/llvm/docs/ConvergenceAndUniformity.rst b/llvm/docs/ConvergenceAndUniformity.rst
index 7ff9463d86cad..3d333ba1128bd 100644
--- a/llvm/docs/ConvergenceAndUniformity.rst
+++ b/llvm/docs/ConvergenceAndUniformity.rst
@@ -4,8 +4,6 @@
 Convergence And Uniformity
 ==========================
 
-.. contents::
-   :local:
 
 Introduction
 ============
diff --git a/llvm/docs/ConvergentOperations.rst b/llvm/docs/ConvergentOperations.rst
index cdd3e89aba1f4..d29711804c90e 100644
--- a/llvm/docs/ConvergentOperations.rst
+++ b/llvm/docs/ConvergentOperations.rst
@@ -2,9 +2,6 @@
 Convergent Operation Semantics
 ==============================
 
-.. contents::
-   :local:
-   :depth: 4
 
 Overview
 ========
diff --git a/llvm/docs/Coroutines.md b/llvm/docs/Coroutines.md
index d541dbd3784b1..e7f629bf4ef08 100644
--- a/llvm/docs/Coroutines.md
+++ b/llvm/docs/Coroutines.md
@@ -1,9 +1,5 @@
 # Coroutines in LLVM
 
-```{contents}
-:local:
-:depth: 3
-```
 
 ```{warning}
 Compatibility across LLVM releases is not guaranteed.
diff --git a/llvm/docs/CoverageMappingFormat.md b/llvm/docs/CoverageMappingFormat.md
index 4f72e1736de59..7b4690f4bb1c7 100644
--- a/llvm/docs/CoverageMappingFormat.md
+++ b/llvm/docs/CoverageMappingFormat.md
@@ -1,8 +1,5 @@
 # LLVM Code Coverage Mapping Format
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/CycleTerminology.md b/llvm/docs/CycleTerminology.md
index 136d379268f86..50cc94879602e 100644
--- a/llvm/docs/CycleTerminology.md
+++ b/llvm/docs/CycleTerminology.md
@@ -2,9 +2,6 @@
 
 # LLVM Cycle Terminology
 
-```{contents}
-:local:
-```
 
 (cycle-definition)=
 
diff --git a/llvm/docs/DTLTO.md b/llvm/docs/DTLTO.md
index 19fa0741d03f1..c498cae3b8ebf 100644
--- a/llvm/docs/DTLTO.md
+++ b/llvm/docs/DTLTO.md
@@ -1,9 +1,5 @@
 # DTLTO
 
-```{contents}
-:depth: 2
-:local:
-```
 
 ```{toctree}
 :maxdepth: 1
diff --git a/llvm/docs/DependenceGraphs/index.rst b/llvm/docs/DependenceGraphs/index.rst
index 7e8c73cad0008..62f32d52796b9 100644
--- a/llvm/docs/DependenceGraphs/index.rst
+++ b/llvm/docs/DependenceGraphs/index.rst
@@ -2,8 +2,6 @@
 Dependence Graphs in LLVM
 =========================
 
-.. contents::
-   :local:
 
 Introduction
 ============
diff --git a/llvm/docs/DeveloperPolicy.md b/llvm/docs/DeveloperPolicy.md
index aec17fa9b2b9f..173046650d677 100644
--- a/llvm/docs/DeveloperPolicy.md
+++ b/llvm/docs/DeveloperPolicy.md
@@ -1,9 +1,6 @@
 (developer_policy)=
 # LLVM Developer Policy
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/DirectX/DXContainer.rst b/llvm/docs/DirectX/DXContainer.rst
index 4a706afd7bd60..d35a2333deff9 100644
--- a/llvm/docs/DirectX/DXContainer.rst
+++ b/llvm/docs/DirectX/DXContainer.rst
@@ -2,8 +2,6 @@
 DirectX Container
 =================
 
-.. contents::
-   :local:
 
 .. toctree::
    :hidden:
diff --git a/llvm/docs/DirectX/DXILArchitecture.rst b/llvm/docs/DirectX/DXILArchitecture.rst
index bce7fdaa386ed..1d7b96c35fc3e 100644
--- a/llvm/docs/DirectX/DXILArchitecture.rst
+++ b/llvm/docs/DirectX/DXILArchitecture.rst
@@ -2,8 +2,6 @@
 Architecture and Design of DXIL Support in LLVM
 ===============================================
 
-.. contents::
-   :local:
 
 .. toctree::
    :hidden:
diff --git a/llvm/docs/DirectX/DXILOpTableGenDesign.rst b/llvm/docs/DirectX/DXILOpTableGenDesign.rst
index 46106ee2a50f5..2673bda7463cf 100644
--- a/llvm/docs/DirectX/DXILOpTableGenDesign.rst
+++ b/llvm/docs/DirectX/DXILOpTableGenDesign.rst
@@ -1,8 +1,6 @@
 ==============================================================
 Specification of DXIL Operations using TableGen Representation
 ==============================================================
-.. contents::
-   :local:
 
 .. toctree
    :hidden
diff --git a/llvm/docs/DirectX/DXILResources.rst b/llvm/docs/DirectX/DXILResources.rst
index 4471a248108cf..3c922c888b40f 100644
--- a/llvm/docs/DirectX/DXILResources.rst
+++ b/llvm/docs/DirectX/DXILResources.rst
@@ -2,8 +2,6 @@
 DXIL Resource Handling
 ======================
 
-.. contents::
-   :local:
 
 .. toctree::
    :hidden:
diff --git a/llvm/docs/DirectX/RootSignatures.rst b/llvm/docs/DirectX/RootSignatures.rst
index e328b4a32cf12..9341100d80ff2 100644
--- a/llvm/docs/DirectX/RootSignatures.rst
+++ b/llvm/docs/DirectX/RootSignatures.rst
@@ -2,8 +2,6 @@
 Root Signatures
 ===============
 
-.. contents::
-   :local:
 
 .. toctree::
    :hidden:
diff --git a/llvm/docs/DirectXUsage.rst b/llvm/docs/DirectXUsage.rst
index eb5e0a67f1fc8..dc795cd7f53df 100644
--- a/llvm/docs/DirectXUsage.rst
+++ b/llvm/docs/DirectXUsage.rst
@@ -7,8 +7,6 @@ User Guide for the DirectX Target
    It is not yet feature complete or ready to be used outside of experimental or
    demonstration contexts.
 
-.. contents::
-   :local:
 
 .. toctree::
    :hidden:
diff --git a/llvm/docs/ExceptionHandling.md b/llvm/docs/ExceptionHandling.md
index 9445f491f5238..978baee70e74d 100644
--- a/llvm/docs/ExceptionHandling.md
+++ b/llvm/docs/ExceptionHandling.md
@@ -1,8 +1,5 @@
 # Exception Handling in LLVM
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/Extensions.md b/llvm/docs/Extensions.md
index 2906b4c3f1b78..aaaa4b1d8a013 100644
--- a/llvm/docs/Extensions.md
+++ b/llvm/docs/Extensions.md
@@ -1,8 +1,5 @@
 # LLVM Extensions
 
-```{contents}
-:local:
-```
 
 ```{toctree}
 :hidden:
diff --git a/llvm/docs/FAQ.md b/llvm/docs/FAQ.md
index 1b7d5e6a55923..f4cd113e4d2ba 100644
--- a/llvm/docs/FAQ.md
+++ b/llvm/docs/FAQ.md
@@ -1,8 +1,5 @@
 # Frequently Asked Questions (FAQ)
 
-```{contents}
-:local:
-```
 
 
 ## License
diff --git a/llvm/docs/FatLTO.rst b/llvm/docs/FatLTO.rst
index c883513feb6ba..d5c2e773d8eda 100644
--- a/llvm/docs/FatLTO.rst
+++ b/llvm/docs/FatLTO.rst
@@ -1,9 +1,6 @@
 ===================
 FatLTO
 ===================
-.. contents::
-   :local:
-   :depth: 2
 
 .. toctree::
    :maxdepth: 1
diff --git a/llvm/docs/FaultMaps.rst b/llvm/docs/FaultMaps.rst
index 5dc5e574fd2fa..bffd0d0c01cb8 100644
--- a/llvm/docs/FaultMaps.rst
+++ b/llvm/docs/FaultMaps.rst
@@ -2,9 +2,6 @@
 FaultMaps and implicit checks
 ==============================
 
-.. contents::
-   :local:
-   :depth: 2
 
 Motivation
 ==========
diff --git a/llvm/docs/Frontend/PerformanceTips.md b/llvm/docs/Frontend/PerformanceTips.md
index 64859400c4a07..06db1396a9d7f 100644
--- a/llvm/docs/Frontend/PerformanceTips.md
+++ b/llvm/docs/Frontend/PerformanceTips.md
@@ -1,9 +1,5 @@
 # Performance Tips for Frontend Authors
 
-```{contents}
-:depth: 2
-:local:
-```
 
 ## Abstract
 
diff --git a/llvm/docs/FuzzingLLVM.rst b/llvm/docs/FuzzingLLVM.rst
index 76eb4288a1f2c..f1df0c979c9fe 100644
--- a/llvm/docs/FuzzingLLVM.rst
+++ b/llvm/docs/FuzzingLLVM.rst
@@ -2,9 +2,6 @@
 Fuzzing LLVM libraries and tools
 ================================
 
-.. contents::
-   :local:
-   :depth: 2
 
 Introduction
 ============
diff --git a/llvm/docs/GarbageCollection.md b/llvm/docs/GarbageCollection.md
index a94e566f8feb2..d692160c0bce4 100644
--- a/llvm/docs/GarbageCollection.md
+++ b/llvm/docs/GarbageCollection.md
@@ -1,8 +1,5 @@
 # Garbage Collection with LLVM
 
-```{contents}
-:local:
-```
 
 ## Abstract
 
diff --git a/llvm/docs/GetElementPtr.rst b/llvm/docs/GetElementPtr.rst
index 09389a0af751f..60ca2c75593ae 100644
--- a/llvm/docs/GetElementPtr.rst
+++ b/llvm/docs/GetElementPtr.rst
@@ -2,8 +2,6 @@
 The Often Misunderstood GEP Instruction
 =======================================
 
-.. contents::
-   :local:
 
 Introduction
 ============
diff --git a/llvm/docs/GettingInvolved.md b/llvm/docs/GettingInvolved.md
index 797b4a9ee5edc..4a8abd97276ea 100644
--- a/llvm/docs/GettingInvolved.md
+++ b/llvm/docs/GettingInvolved.md
@@ -2,9 +2,6 @@
 
 LLVM welcomes contributions of all kinds. To get started, please review the following topics:
 
-```{contents}
-:local:
-```
 
 ```{toctree}
 :hidden:
diff --git a/llvm/docs/GettingStarted.md b/llvm/docs/GettingStarted.md
index dacca0adff7c2..5c1789de9ef39 100644
--- a/llvm/docs/GettingStarted.md
+++ b/llvm/docs/GettingStarted.md
@@ -1,8 +1,5 @@
 # Getting Started with the LLVM System
 
-```{contents}
-:local:
-```
 
 ## Overview
 
diff --git a/llvm/docs/GettingStartedVS.md b/llvm/docs/GettingStartedVS.md
index 232b5ab15fae2..66b5d7763adef 100644
--- a/llvm/docs/GettingStartedVS.md
+++ b/llvm/docs/GettingStartedVS.md
@@ -1,8 +1,5 @@
 # Getting Started with the LLVM System using Microsoft Visual Studio
 
-```{contents}
-:local:
-```
 
 ## Overview
 
diff --git a/llvm/docs/GitHub.md b/llvm/docs/GitHub.md
index 6e343a66e5586..c08d05a0adc60 100644
--- a/llvm/docs/GitHub.md
+++ b/llvm/docs/GitHub.md
@@ -2,9 +2,6 @@
 
 # LLVM GitHub User Guide
 
-```{contents}
-:local:
-```
 
 ## Introduction
 
diff --git a/llvm/docs/GlobalISel/GM...
[truncated]

``````````

</details>


https://github.com/llvm/llvm-project/pull/211993
