Documentation doesn't get updated

Project Infrastructure LLVM Dev List Archives
1

Hi Tanya,

Last time I noticed a problem with clang-tools-extra docs you could help solving them. If someone else is taking care of this part of the infrastructure now, please redirect appropriately.

It looks like docs generated from rst (for LLVM, Clang and clang-tools-extra) don’t get updated at the moment. They stopped updating somewhere between r353327 (which made it to http://clang.llvm.org/extra/clang-tidy/checks/modernize-avoid-c-arrays.html) and r353374 (which didn’t make it to https://llvm.org/docs/GettingStarted.html#host-c-toolchain-both-compiler-and-standard-library). The llvm-sphinx-docs, clang-sphinx-docs (until recently) and clang-tools-sphinx-docs buildbots have been green, so there doesn’t seem to be any problem with the rst files (at least, with the sphinx version used by the docs buildbots).

Could you take a look at what’s happening?

Thanks!

– Alex

2

Tanya,

I’m not sure if its related, but if I build inside clang/docs with Sphinx v1.6.5 I get

/usr/bin/sphinx-build -n -W ./docs ./html
Running Sphinx v1.6.5
loading pickled environment… not yet created
building [mo]: targets for 0 po files that are out of date
building [html]: targets for 67 source files that are out of date
updating environment: 67 added, 0 changed, 0 removed
reading sources… [100%] index

Warning, treated as error:
/clang/llvm/tools/clang/docs/ClangCommandLineReference.rst:22:Duplicate explicit target name: “cmdoption-clang–prefix”.
make: *** [Makefile:32: check_sphinx_docs] Error 1

MyDeveloperDay

3

That’s been an issue for I believe almost a year, the workaround is -DSPHINX_WARNINGS_AS_ERRORS=OFF.

4

Tanya, friendly ping.

5

Yes, I am working on it. The sub-projects are still having issues but the other documentation has been fixed.

-Tanya

6

This should all be fixed now.

Thanks,
Tanya

7

Hi Tanya,

I reported another one issue with clang doxygen month ago: http://lists.llvm.org/pipermail/cfe-dev/2019-January/060892.html

Could you please take a look?

Thanks!

8

Thank you! It seems like new changes in .rst files are picked up quickly now.

– Alex

9

It looks like the same error is back: http://lab.llvm.org:8011/builders/clang-sphinx-docs/builds/54106/steps/docs-clang-html/logs/stdio

10

Note that Polly's documentation also hasn't been updated for a while
now. I don't see a 'polly-sphinx-docs' in the builder list. Is it
supposed to exist?

Michael