[flang-commits] [flang] [Flang] Add Sphinx man page and html support for Flang (PR #141882)
Tarun Prabhu via flang-commits
flang-commits at lists.llvm.org
Tue Jun 3 10:10:49 PDT 2025
tarunprabhu wrote:
> > I am not very familiar with the way the manpage for clang is generated. Does [clang.rst](https://github.com/llvm/llvm-project/blob/main/clang/docs/CommandGuide/clang.rst) have to be manually kept up to date with any command line options that are added?
>
> Whether anyone wants a giant manpage with everything on it, I'm not a regular user of man pages so I can't say what's appropriate or not. Certainly the basic structure of subsections and titles is a good idea.
I have always found it frustrating that the man page for `clang` did not have all the options, but that might be me. I don't think that the pages for Flang's design belong in a man page though.
We may want to consider auto-generating a command-line reference and having that in the man page, but that is a broader, and potentially longer, discussion that should not hold up this PR.
https://github.com/llvm/llvm-project/pull/141882
More information about the flang-commits
mailing list