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