[llvm] r213661 - Treat warnings in Sphinx as errors. The reasons for doing this are...

[Dan Liew]

>> @Reid: Would you be happy if I changed this behaviour in CMake so that
>> warnings are not treated as errors?
>
>
> I'd rather figure something else out.

Ok.

> I think the best end state would be:
> - All build systems (CMake and make) default to warnings-as-errors
> - llvm.org builds docs without warnings-as-errors
> - Get at least one bot to build the sphinx documentation and send IRC pings

I did actually send out an e-mail about this (build bot for
documentation) in April [1] and Dmitri (CC'ed) offered a host but
unfortunately I never found time to do it mainly because I'm not
familiar with BuildBot (and LLVM's configurations) and would need to
invest quite a bit of time to make sure I do it correctly.

> If nobody has the energy for that, I don't think the status quo is too bad.
> If somebody bothers to build with the cmake build system, they'll get the
> (IMO) intuitive behavior for a build system: the build succeeds if the
> markup was good.

The first two points should hopefully be easy. Setting up the build
bot is a bit more work and I don't really have the time to do it right
now.

Thanks,
Dan.

[1] http://lists.cs.uiuc.edu/pipermail/llvmdev/2014-April/072488.html