www-scripts Sphinx doc builder broken and needs intervention.

Project Infrastructure LLVM Dev List Archives
#1

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

#2

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

#3

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.

#4

Ping. Everything is still broken.

#5

Ping. It’s been another week.

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

#6

llvm fixed yesterday. Others fixed now.

-Tanya

#7

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

#8

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

#9

@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.

#10

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.

#11

Great. This was all information I needed. Thanks!

Tobias

#12

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

Thanks

/Eric