www-scripts Sphinx doc builder broken and needs intervention.

Hi Tanya,

The www-scripts builder that updates the Sphinx documentation has been broken for about a week now, despite the buildbot builders passing.

The error from the last sphinx update attempt says:

/opt/tools/sphinx_update.sh: warning: removing stale lock file from PID 8798.
UPDATING lld SOURCES
Updating ‘.’:
At revision 302593.
make: *** No rule to make target `docs-lld-html’. Stop.

This is likely due to recent changes to the CMake Sphinx configuration, that would require at least re-configuring CMake but likely require removing the build cache and reconfiguring it all together.

Ideally the script would re-configure CMake every time it runs to prevent this sort of problem in the future.

/Eric

What if the script would do cmake --build instead of direct make
invocation? I believe, this would solve the problem, no?

I don’t know if that would make a difference. Whenever a CMake file is changed and a build
rule is executed CMake is automatically re-run, but the variables in the cache remain.
Since certain configuration doesn’t re-run once a variable is in the cache, a bad cache variable
can break the build until it’s manually removed. I believe that’s what’s happening here.

I should clarify that when I originally said “reconfigure” I meant deleting the existing build directory and starting
fresh.

Ping. Everything is still broken.

Ping. It’s been another week.

When are we going to get the docs building and updating again?

llvm fixed yesterday. Others fixed now.

-Tanya

Thanks Tanya,

Unfortunately it seems like clang-tools-extra has started failing again, with the similar error message “make: *** No rule to make target `docs-clang-tools-html’. Stop.”

I’m not sure if this is an error on your end or within clang-tools-extra. I’ll investigate more tomorrow.

/Eric

Thanks Tanya,

Unfortunately it seems like `clang-tools-extra` has started failing
again,
with the similar error message "make: *** No rule to make target
`docs-clang-tools-html'. Stop."

I'm not sure if this is an error on your end or within clang-tools-extra.
I'll investigate more tomorrow.

Yes, thank you Tanja. The Polly docs also do not yet seem up-to-date:

http://polly.llvm.org/docs/

despite a recent push to the docs and waiting at least an hour in case
the builds only take place hourly. Or are these only nightly builds?

Best,
Tobias

@Tobias The poly docs build step is still failing, but due to a bug in the particular version of Sphinx used by the www-scripts builder.
This seems like something best worked around inside poly.

The builds take place hourly and their output is reported on the www-scripts@lists.llvm.org mailing list.

Eric is correct. However, LLVM docs are on another server. We are working hard to centralize everything again and fix the sphinx version problems. Those docs are updated post commit.

Great. This was all information I needed. Thanks!

Tobias

FYI everything appears to be working and the www-scripts builder is currently reporting success.

Thanks

/Eric