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

[Hans Wennborg via llvm-commits]

On Tue, Jul 26, 2016 at 9:12 AM, Aaron Ballman <aaron at aaronballman.com> wrote:
> 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).

Thanks. I haven't started looking at building the docs yet, but if it
doesn't work I'll have a look at your commits.

Cheers,
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