Flang homepage is broken

Subprojects Flang
1

Not sure what happened, currently looks misrendered both in Chrome & Firefox. The subpages look the same. Screenshot below

image
image2617×1480 314 KB

[RFC] Fortran language feature documentation
2

Thanks for the report. Some of this is auto-generated, rest is from https://github.com/llvm/llvm-project/tree/main/flang/docs and the templates files there.

3

It’s been almost two months since Flang’s documentation has built and it’s still failing: Buildbot

Is someone from Flang actively working on Flang's documentation build is broken · Issue #70199 · llvm/llvm-project · GitHub? (I ask because I watch the sphinx publication bot for issues and it’s gotten much harder to spot new issues because of the overwhelming amount of failures from Flang, so this has gotten disruptive at this point.)

4

I will look into this today.

1 Like
5

Thank you, I really appreciate it! If you need help, please let me know and I can try to lend a hand.

1 Like
6

We are now down to two warnings in the flang docs generation build. The first one is from mlir-tblgen but I don’t understand why there is a warning there. The second one comes from a generated file (FlangCommandLineReference.rst) which probably needs a discussion.

mlir-tblgen/OpDefinitionsGen.cpp:2954:38: warning: unused variable ‘operand’ [-Wunused-variable]
 2954 |     if ([[maybe_unused]] const auto *operand =
      |                                      ^~~~~~~

/home/buildbot/as-worker-4/publish-sphinx-docs/build/tools/flang/docs/Source/FlangCommandLineReference.rst:176: WARNING: unknown document: 'DiagnosticsReference'

Thanks @AaronBallman for the reviews.

The website (Welcome to Flang’s documentation — The Flang Compiler) does not look any better though even after these fixes. So probably there is some other issue as well.

7

/home/buildbot/as-worker-4/publish-sphinx-docs/build/tools/flang/docs/Source/FlangCommandLineReference.rst:176: WARNING: unknown document: 'DiagnosticsReference'

We get this when building docs locally for Clang as well; some of our documentation is table generated, so if clang-tblgen doesn’t run, it won’t produce some .rst files that the TOC expects to find. It looks like Flang may need to run the tblgen command to generate the diagnostic reference as part of CMake so that the .rst file is generated before we run Sphinx to make the final docs.

Thanks @AaronBallman for the reviews.

Happy to help, thank you for the fixes! The latest Sphinx build is looking much better: Buildbot

The only warning I see specific to Sphinx is the one about DiagnosticReference not being known. The other warnings are not from sphinx.