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

[Hans Wennborg via llvm-commits]

I went ahead and merged to 3.9 in r276758.

Thanks,
Hans

On Tue, Jul 26, 2016 at 5:30 AM, Hahnfeld, Jonas
<Hahnfeld at itc.rwth-aachen.de> wrote:
> Ping, would be great.
>
> Thanks,
> Jonas
>
>> -----Original Message-----
>> From: hwennborg at google.com [mailto:hwennborg at google.com] On Behalf
>> Of Hans Wennborg
>> Sent: Wednesday, July 20, 2016 3:28 PM
>> To: Hahnfeld, Jonas
>> Cc: Renato Golin; llvm-commits at lists.llvm.org
>> Subject: Re: [llvm] r276109 - [docs] Fixing Sphinx warnings to unclog the
>> buildbot
>>
>> 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.