<div dir="ltr"><div dir="ltr">Thanks all. I confirmed that I'm using the correct version of Sphinx/recommonmark. The warning I was seeing about a duplicate label doesn't appear to affect the actual build.</div><div dir="ltr"><br></div><div>-DeForest<br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Sep 16, 2019 at 4:09 AM Roman Lebedev <<a href="mailto:lebedev.ri@gmail.com">lebedev.ri@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">clang's docs are not sphinx warning-clean, therefore you should pass<br>
-DSPHINX_WARNINGS_AS_ERRORS=OFF<br>
<br>
<br>
On Mon, Sep 16, 2019 at 1:06 PM James Henderson via llvm-dev<br>
<<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>> wrote:<br>
><br>
> Hi DeForest,<br>
><br>
> What version of sphinx and recommonmark are you using? Jordan (cc'ed) and I did some investigation a few months ago, and discovered that the different versions can cause significantly different behaviours, up to and including different warnings on occasion. As a result, it's important to match the version on the build bots. You can see this email thread for more discussion re. different versions of recommonmark and sphinx. IIRC, you should use version 0.4.0 and 1.7.9 respectively.<br>
><br>
> FWIW, it looks like the build bot is currently green.<br>
><br>
> James<br>
><br>
> On Fri, 13 Sep 2019 at 21:52, via llvm-dev <<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>> wrote:<br>
>><br>
>> Last night, I triggered a buildbot error after my most recent commit. That one was totally on me as the warning did pop up while generating the docs site locally using the sphinx-build command (confirmed this afternoon).<br>
>><br>
>> I just checked in a commit to resolve the error but now it appears I've triggered a different buildbot error? This error did not come up when I built the site locally to test my bug fix. I'm still trying to resolve this error as I don't actually see the duplicate label (index-subsystem-docs) in index.rst. Here's the error message:<br>
>><br>
>> /home/buildbot/llvm-build-dir/llvm-sphinx-docs/llvm/src/docs/SubsystemDocumentation.rst:4:<br>
>> WARNING: duplicate label index-subsystem-docs, other instance in /home/buildbot/llvm-build-dir/llvm-sphinx-docs/llvm/src/docs/index.rst<br>
>><br>
>><br>
>> Going forward, are there additional steps I can take when building/testing locally so that I can make sure this doesn't happen with future commits?<br>
>><br>
>> -DeForest<br>
>> _______________________________________________<br>
>> LLVM Developers mailing list<br>
>> <a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a><br>
>> <a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
><br>
> _______________________________________________<br>
> LLVM Developers mailing list<br>
> <a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a><br>
> <a href="https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
</blockquote></div></div>