[cfe-dev] Transitioning Clang's docs/ to Sphinx

Sean Silva silvas at purdue.edu
Fri Dec 7 13:43:34 PST 2012


Hello everyone,

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.

-- Sean Silva



More information about the cfe-dev mailing list