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

[Aaron Ballman via llvm-commits]

On Tue, Jul 26, 2016 at 12:06 PM, Hans Wennborg via llvm-commits
<llvm-commits at lists.llvm.org> wrote:
> I went ahead and merged to 3.9 in r276758.

We may want to double-check that this is sufficient to fix 3.9's
documentation building issues. I did a handful of related one-off
commits along the same lines that we may have to pull in as well (I
can try to locate those commits if the docs build isn't fixed in 3.9
by this merge).

~Aaron

>
> 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.
> _______________________________________________
> llvm-commits mailing list
> llvm-commits at lists.llvm.org
> http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-commits