[all-commits] [llvm/llvm-project] 47171a: [Flang] Add Sphinx man page and html support for F...

[Samarth Narang via All-commits]

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: 47171ac3f911541453a69f3d9c6b4c1777409b95
      https://github.com/llvm/llvm-project/commit/47171ac3f911541453a69f3d9c6b4c1777409b95
  Author: Samarth Narang <70980689+snarang181 at users.noreply.github.com>
  Date:   2025-06-04 (Wed, 04 Jun 2025)

  Changed paths:
    M flang/docs/CMakeLists.txt
    A flang/docs/CommandGuide/index.rst
    M flang/docs/FIR/CreateFIRLangRef.py
    M flang/docs/conf.py

  Log Message:
  -----------
  [Flang] Add Sphinx man page and html support for Flang (#141882)

This patch refactors the Flang documentation CMake and Sphinx
configuration to address build issues.

**CMake changes**:

- Moves the `gen_rst_file_from_td()` call out of the HTML-only block so
that both `docs-flang-html` and `docs-flang-man` builds depend on the
generated `FlangCommandLineReference.rst` file.

**conf.py changes**:
- Introduces `myst_parser` dependency as a required Markdown parser for
both HTML and man builds.
- Introduces the correct source_suffix mapping for both .rst and .md
files.
- Populates the man_pages configuration so the main index page generates
a ` flang(1) `man page.

Fixes #141757

---------

Authored-by: Samarth Narang <samanara at qti.qualcomm.com>



To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications