As we finish converting LLVM's docs/ to Sphinx, transitioning Clang's
docs/ to Sphinx is now in the pipeline. It is my understanding that
this is something generally wanted by the community (if not, please
holler).
The conversion of LLVM's documentation to Sphinx has taken a long
time, but this conversion will be much faster, if only because my (and
others', I presume) techniques. The conversion of llvm/docs/tutorial/
I did in r169343 was singlehandedly 1.5x larger than all of Clang's
docs combined; the conversion took approximately 4 hours.
Daniel, IIRC you were the one that set up the Sphinx stuff for LLVM
and LLD. I know how to do all the Sphinx configuration, but I'm not
sure what exactly needs to be done on llvm.org's servers to get the
Sphinx docs to correctly regenerate on each checkin and be hosted on llvm.org/docs, so I'm unsure how to get them to display on clang.llvm.org/docs. Could you give me some pointers or set things up
for that? Thanks.
Here's a patch [1] that converts the following Clang documents to reST:
docs/LanguageExtensions.rst
docs/LibASTMatchers.rst
docs/LibTooling.rst
docs/PCHInternals.rst
docs/ThreadSanitizer.rst
docs/Tooling.rst
The patch is prepared by Mykhailo Pustovit, with review and minor edits by me.
Can not commit it yet, infrastructure is not ready.
Initial sphinx setup should be done in r170042. It should build just
like the LLVM one did (just do `make -f Makefile.sphinx` and
everything should be in _build/html/).