[flang-commits] [flang] [Flang] Add Sphinx man page and html support for Flang (PR #141882)

[Paul Osmialowski via flang-commits]

pawosm-arm wrote:

> > @pawosm-arm, can you test it out?
> 
> Yes I'll trigger another build today.

It looks much better now. Although the `Introduction` section looks weird (the way it starts going directly to listing the command line options), but I tend to agree that it's a good for the starters and the proper refinement should happened later and should wait for the contributors to pick it up. For now it looks as such:

```
FLANG(1)                                Flang                               FLANG(1)

NAME
       flang - Flang Documentation (In Progress)

       NOTE:
          This man page is under development.

       For full documentation, please see the online HTML docs:

       https://flang.llvm.org/docs/

                                           ----

FLANG COMMAND LINE REFERENCE
   Flang command line argument reference
       o Introduction

       o Actions

       o Compilation options

         o Preprocessor options

           o Include path management

           o Dumping preprocessor state

         o Diagnostic options

         o Target-independent compilation options

           o Common Offloading options

           o HIP options

         o Target-dependent compilation options

           o AARCH64

           o X86

           o LoongArch

         o Optimization level

         o Debug information generation

           o Kind and level of debug information

             o Debug level

       o Linker options

   Introduction
       -B<prefix>

       Search $prefix$file for executables, libraries, and data files. If $prefix is
       a directory, search $prefix/$file

       -Qunused-arguments

       Don't emit warning for unused driver arguments

       --config=<file>, --config <arg>
 Manual page flang(1) line 1 (press h for help or q to quit)
```

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