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

[Hahnfeld, Jonas via llvm-commits]

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.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 5868 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/llvm-commits/attachments/20160726/bd0d043c/attachment.bin>