docs-llvm-html broken?

Project Infrastructure LLVM Dev List Archives
#1

Hi,

docs seem to be broken.
e.g. r353563 adds docs for callbr, but
https://llvm.org/docs/LangRef.html doesn’t have it.

trying to build the docs manually on my box:

ninja docs-llvm-html

FAILED: docs/CMakeFiles/docs-llvm-html
cd /usr/local/google/home/kcc/llvm-build/docs && /usr/bin/sphinx-build -b html -d /usr/local/google/home/kcc/llvm-build/docs/_doctrees-llvm-html -q -W /usr/local/google/home/kcc/llvm/docs /usr/local/google/home/kcc/llvm-build/docs/html

Extension error:
Could not import recommonmark.parser (needed for source parser) (exception: No module named recommonmark.parser)
ninja: build stopped: subcommand failed.

Any thoughts?

Thanks!

–kcc

#2

Hi Kostya,

I remember seeing this in the past. IIRC it was sufficient to install recommonmark with pip install recommonmark.

Cheers,
Jonas

#3

Hi Kostya,

I remember seeing this in the past. IIRC it was sufficient to install recommonmark with pip install recommonmark.

installing this on my machine won’t help the bots that build the docs, right?

#4

Hi Kostya,

I remember seeing this in the past. IIRC it was sufficient to install
recommonmark with `pip install recommonmark`.

installing this on my machine won't help the bots that build the docs,
right?

From your original e-mail I understood this only happened locally. The

sphinx bot (http://lab.llvm.org:8011/builders/llvm-sphinx-docs) is green so
I don't think there's a problem with the docs itself. However, I recently
learned this bot doesn't update the website and that there's as script to
do that. +Tanya who should be able to help with this.

#5

There is a mailing list (www-scripts@lists.llvm.org) that receives the logs from the doc regeneration scripts so that we can debug these problems ourselves without help from Tanya, Mike, or anyone else with direct access to the infrastructure. I see some error logs here:
http://lists.llvm.org/pipermail/www-scripts/2019-February/thread.html

Hopefully that helps.

#6

Cool, I didn’t know about this.

Looks like it’s the result of the new compiler policy.

#7

The bot apparently needs a toolchain update. Some recipes I added to
GitHubMove.rst to help people transition to the monorepo haven't made it
to the website yet. It'd be nice to get those available to people.

                        -David

Reid Kleckner via llvm-dev <llvm-dev@lists.llvm.org> writes:

#8

Will investigate and fix ASAP.

-Tanya

#9

Cool, I didn’t know about this.

Looks like it’s the result of the new compiler policy.

indeed. I thought I’d captured all the bots that were failing because of that migration. Seems that wasn’t the case :frowning: