[Openmp-commits] [clang] [clang-tools-extra] [flang] [libc] [libcxx] [libunwind] [lld] [lldb] [llvm] [openmp] [polly] [3/4]: [docs] Create utils/docs (PR #203962)

[Scott Linder via Openmp-commits]

slinder1 wrote:

> FWIW, I've started seeing this failure locally when trying to build documentation on Windows:
> 
> ```
> F:\source\llvm-project\clang\docs>make html
> Running Sphinx v7.2.6
> 
> Configuration error:
> There is a programmable error in your configuration file:
> 
> Traceback (most recent call last):
>   File "C:\Users\aballman\AppData\Roaming\Python\Python310\site-packages\sphinx\config.py", line 358, in eval_config_file
>     exec(code, namespace)  # NoQA: S102
>   File "F:\source\llvm-project\clang\docs\conf.py", line 18, in <module>
>     from llvm_sphinx import *  # see llvm-project/utils/docs/README.md
> ModuleNotFoundError: No module named 'llvm_sphinx'
> ```
> 
> am I holding something wrong?

Do you have any more info on your setup that might help me reproduce the issue?

On windows using the default generator for me (`MSBuild`) I don't see any issues:

```
cmake -B build -S llvm -DLLVM_ENABLE_SPHINX=ON
cmake --build build --parallel 8 -t docs-llvm-html
  1>Generating html Sphinx documentation for llvm into "C:/Users/slinder1/llvm-project/build/docs/html"
```

The build succeeds without any other messages, and the HTML generated seems fine.

It looks like you're using `make`, so maybe I'm not testing with the right setup?

https://github.com/llvm/llvm-project/pull/203962