[clang-tools-extra] [clang-tools-extra][docs] Do not require myst_parser when building man pages (PR #201138)
via cfe-commits
cfe-commits at lists.llvm.org
Tue Jun 2 07:54:00 PDT 2026
llvmorg-github-actions[bot] wrote:
<!--LLVM PR SUMMARY COMMENT-->
@llvm/pr-subscribers-clang-tools-extra
Author: David Spickett (DavidSpickett)
<details>
<summary>Changes</summary>
---
Full diff: https://github.com/llvm/llvm-project/pull/201138.diff
1 Files Affected:
- (modified) clang-tools-extra/docs/conf.py (+12-2)
``````````diff
diff --git a/clang-tools-extra/docs/conf.py b/clang-tools-extra/docs/conf.py
index b0174894c4e4a..8247cd173fcf6 100644
--- a/clang-tools-extra/docs/conf.py
+++ b/clang-tools-extra/docs/conf.py
@@ -13,7 +13,6 @@
import sys, os
from datetime import date
-import myst_parser
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
@@ -27,7 +26,18 @@
# Add any Sphinx extension module names here, as strings. They can be extensions
# coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = ["sphinx.ext.todo", "sphinx.ext.mathjax", "myst_parser"]
+extensions = ["sphinx.ext.todo", "sphinx.ext.mathjax"]
+
+# When building man pages, we do not use the markdown pages,
+# So, we can continue without the myst_parser dependencies.
+# Doing so reduces dependencies of some packaged llvm distributions.
+try:
+ import myst_parser
+
+ extensions.append("myst_parser")
+except ImportError:
+ if not tags.has("builder-man"):
+ raise
# Add any paths that contain templates here, relative to this directory.
templates_path = ["_templates"]
``````````
</details>
https://github.com/llvm/llvm-project/pull/201138
More information about the cfe-commits
mailing list