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

[Samarth Narang via flang-commits]

snarang181 wrote:

> > > > > https://reviews.llvm.org/D128650
> > > > 
> > > > 
> > > > @kiranchandramohan -- this runs for me successfully and does not interfere with the placeholder file. The final `FIRLangRef.md` that is produced in the build artifacts has been generated by tablegen.
> > > 
> > > 
> > > What about the man pages and its contents. Is it the empty file or the one produced by tablegen?
> > 
> > 
> > As I mentioned the man page produced at `${BUILD_DIR}/tools/flang/docs/man/flang.1` looks like the one produced by tablegen. The `FIRLangRef.md` looks to be completely overwritten in the build directory. For the other placeholder file, `FlangCommandLineReference.md`, there is no fallout either.
> 
> Can we do something similar to https://reviews.llvm.org/D128650 to avoid needing dummy `FIRLangRef.md` and `FlangCommandLineReference`?

@kiranchandramohan, I removed the placeholder `.md` files and the man pages get generated now. Just a warning of the form 
`WARNING: toctree contains reference to nonexisting document 'FIRLangRef'`
`WARNING: toctree contains reference to nonexisting document 'FlangCommandLineReference'`
This is probably OK?

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