| # utils/docs | |
| Common configuration and extensions for all of the sphinx projects in the | |
| llvm-project monorepo (e.g. `llvm/docs/`, `clang/docs/`, `bolt/docs`, ...). | |
| This directory is injected into the `PYTHONPATH` of `sphinx-build` processes as | |
| part of the llvm-project CMake build. | |
| **Note:** On the command-line, you must manually ensure this directory is part | |
| of your `PYTHONPATH`. For example, to use `sphinx-autobuild` for projects which | |
| support it, you might use: | |
| ``` | |
| $ PYTHONPATH=$PWD/utils/docs sphinx-autobuild llvm/docs/ /tmp/sphinx-build | |
| ``` | |
| ## Testing your Environment | |
| To smoke-test your sphinx environment outside of a CMake build, you can use the | |
| `utils/docs/__main__.py` entrypoint (e.g. `python3 utils/docs --test`). |