[llvm] r276109 - [docs] Fixing Sphinx warnings to unclog the buildbot

[Hans Wennborg via llvm-commits]

Sounds good to me. Renato, would you like to merge this over to 3.9?

Thanks,
Hans

On Wed, Jul 20, 2016 at 8:50 AM, Hahnfeld, Jonas
<Hahnfeld at itc.rwth-aachen.de> wrote:
> Hi,
>
> Thanks for fixing these, I also hit them recently.
> Should this be merged for 3.9 to allow the docs being built with sphinx 1.4
> which I think they currently do not?
>
> Thanks,
> Jonas
>
>> -----Original Message-----
>> From: llvm-commits [mailto:llvm-commits-bounces at lists.llvm.org] On Behalf
>> Of Renato Golin via llvm-commits
>> Sent: Wednesday, July 20, 2016 2:17 PM
>> To: llvm-commits at lists.llvm.org
>> Subject: [llvm] r276109 - [docs] Fixing Sphinx warnings to unclog the
>> buildbot
>>
>> Author: rengolin
>> Date: Wed Jul 20 07:16:38 2016
>> New Revision: 276109
>>
>> URL: http://llvm.org/viewvc/llvm-project?rev=276109&view=rev
>> Log:
>> [docs] Fixing Sphinx warnings to unclog the buildbot
>>
>> Lots of blocks had "llvm" or "nasm" syntax types but either weren't
>> following
>> the syntax, or the syntax has changed (and sphinx hasn't keep up) or the
>> type
>> doesn't even exist (nasm?).
>>
>> Other documents had :options: what were invalid. I only removed those that
>> had
>> warnings, and left the ones that didn't, in order to follow the principle of
>> least surprise.
>>
>> This is like this for ages, but the buildbot is now failing on errors. It
>> may
>> take a while to upgrade the buildbot's sphinx, if that's even possible, but
>> that shouldn't stop us from getting docs updates (which seem down for quite
>> a while).
>>
>> Also, we're not losing any syntax highlight, since when it doesn't parse, it
>> doesn't colour. Ie. those blocks are not being highlighted anyway.
>>
>> I'm trying to get all docs in one go, so that it's easy to revert later if
>> we
>> do fix, or at least easy to know what's to fix.