[llvm-dev] Docs: Testing locally but still getting buildbot errors with my commits.

[James Henderson via llvm-dev]

Hi DeForest,

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.

FWIW, it looks like the build bot is currently green.

James

On Fri, 13 Sep 2019 at 21:52, via llvm-dev <llvm-dev at lists.llvm.org> wrote:

> 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).
>
> 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:
>
> /home/buildbot/llvm-build-dir/llvm-sphinx-docs/llvm/src/docs/SubsystemDocumentation.rst:4:
> WARNING: duplicate label index-subsystem-docs, other instance in /home/buildbot/llvm-build-dir/llvm-sphinx-docs/llvm/src/docs/index.rst
>
>
> 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?
>
> -DeForest
> _______________________________________________
> LLVM Developers mailing list
> llvm-dev at lists.llvm.org
> https://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20190916/ffe336b0/attachment.html>