Skip to content

Commit 925c666

Browse files
committed
While building man pages, the .md files were being used.
Due to that, the myst_parser was explictly imported. Adding Placeholder .md files which are required by index.md
1 parent c21b5a0 commit 925c666

File tree

3 files changed

+11
-5
lines changed

3 files changed

+11
-5
lines changed

flang/docs/FIRLangRef.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# FIR Language Reference
2+
3+
_TODO: Add FIR language reference documentation._
Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Flang Command Line Reference
2+
3+
_TODO: Add Flang CLI documentation._

flang/docs/conf.py

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@
1010
# serve to show the default.
1111

1212
from datetime import date
13+
1314
# If extensions (or modules to document with autodoc) are in another directory,
1415
# add these directories to sys.path here. If the directory is relative to the
1516
# documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -28,16 +29,15 @@
2829
"sphinx.ext.autodoc",
2930
]
3031

31-
# When building man pages, we do not use the markdown pages,
32-
# So, we can continue without the myst_parser dependencies.
33-
# Doing so reduces dependencies of some packaged llvm distributions.
32+
3433
try:
3534
import myst_parser
3635

3736
extensions.append("myst_parser")
3837
except ImportError:
39-
if not tags.has("builder-man"):
40-
raise
38+
raise ImportError(
39+
"myst_parser is required to build documentation, including man pages."
40+
)
4141

4242

4343
# Add any paths that contain templates here, relative to this directory.

0 commit comments

Comments
 (0)