[cfe-dev] [llvm-dev] www-scripts Sphinx doc builder broken and needs intervention.

Tobias Grosser via cfe-dev cfe-dev at lists.llvm.org
Thu May 25 20:58:10 PDT 2017


Great. This was all information I needed. Thanks!

Tobias

On Thu, May 25, 2017, at 08:48 PM, Tanya Lattner via llvm-dev wrote:
> Eric is correct. However, LLVM docs are on another server. We are working
> hard to centralize everything again and fix the sphinx version problems.
> Those docs are updated post commit.
> 
> Docs on the other server (all projects and clang) are updated every 30
> min (for web pages), built hourly, and output sent to a mailing list. Its
> confusing right now but once we centralize it will be post commit again.
> 
> -Tanya
> 
> > On May 25, 2017, at 11:00 AM, Eric Fiselier <eric at efcs.ca> wrote:
> > 
> > @Tobias The poly docs build step is still failing, but due to a bug in the particular version of Sphinx used by the www-scripts builder.
> > This seems like something best worked around inside poly.
> > 
> > The builds take place hourly and their output is reported on the www-scripts at lists.llvm.org mailing list.
> > 
> >> On Thu, May 25, 2017 at 12:58 AM, Tobias Grosser <tobias.grosser at inf.ethz.ch> wrote:
> >> On Thu, May 25, 2017, at 08:19 AM, Eric Fiselier via cfe-dev wrote:
> >> > Thanks Tanya,
> >> >
> >> > Unfortunately it seems like `clang-tools-extra` has started failing
> >> > again,
> >> > with the similar error message "make: *** No rule to make target
> >> > `docs-clang-tools-html'.  Stop."
> >> >
> >> > I'm not sure if this is an error on your end or within clang-tools-extra.
> >> > I'll investigate more tomorrow.
> >> 
> >> Yes, thank you Tanja. The Polly docs also do not yet seem up-to-date:
> >> 
> >> http://polly.llvm.org/docs/
> >> 
> >> despite a recent push to the docs and waiting at least an hour in case
> >> the builds only take place hourly. Or are these only nightly builds?
> >> 
> >> Best,
> >> Tobias
> >> 
> >> >
> >> > /Eric
> >> >
> >> > On Wed, May 24, 2017 at 10:54 PM, Tanya Lattner <tanyalattner at llvm.org>
> >> > wrote:
> >> >
> >> > > llvm fixed yesterday. Others fixed now.
> >> > >
> >> > > -Tanya
> >> > >
> >> > > On May 24, 2017, at 8:28 PM, Eric Fiselier <eric at efcs.ca> wrote:
> >> > >
> >> > > Ping. It's been another week.
> >> > >
> >> > > When are we going to get the docs building and updating again?
> >> > >
> >> > > On Tue, May 16, 2017 at 9:01 PM, Eric Fiselier <eric at efcs.ca> wrote:
> >> > >
> >> > >> Ping. Everything is still broken.
> >> > >>
> >> > >> On Wed, May 10, 2017 at 2:39 PM, Eric Fiselier <eric at efcs.ca> wrote:
> >> > >>
> >> > >>> I don't know if that would make a difference. Whenever a CMake file is
> >> > >>> changed and a build
> >> > >>> rule is executed CMake is automatically re-run, but the variables in the
> >> > >>> cache remain.
> >> > >>> Since certain configuration doesn't re-run once a variable is in the
> >> > >>> cache, a bad cache variable
> >> > >>> can break the build until it's manually removed. I believe that's what's
> >> > >>> happening here.
> >> > >>>
> >> > >>> I should clarify that when I originally said "reconfigure" I meant
> >> > >>> deleting the existing build directory and starting
> >> > >>> fresh.
> >> > >>>
> >> > >>> On Tue, May 9, 2017 at 11:57 PM, Anton Korobeynikov <
> >> > >>> anton at korobeynikov.info> wrote:
> >> > >>>
> >> > >>>> What if the script would do cmake --build instead of direct make
> >> > >>>> invocation? I believe, this would solve the problem, no?
> >> > >>>>
> >> > >>>> On Wed, May 10, 2017 at 2:25 AM, Eric Fiselier via llvm-dev
> >> > >>>> <llvm-dev at lists.llvm.org> wrote:
> >> > >>>> > Hi Tanya,
> >> > >>>> >
> >> > >>>> > The www-scripts builder that updates the Sphinx documentation has been
> >> > >>>> > broken for about a week now, despite the buildbot builders passing.
> >> > >>>> >
> >> > >>>> > The error from the last sphinx update attempt says:
> >> > >>>> >
> >> > >>>> >> /opt/tools/sphinx_update.sh: warning: removing stale lock file from
> >> > >>>> PID
> >> > >>>> >> 8798.
> >> > >>>> >> UPDATING lld SOURCES
> >> > >>>> >> Updating '.':
> >> > >>>> >> At revision 302593.
> >> > >>>> >> make: *** No rule to make target `docs-lld-html'.  Stop.
> >> > >>>> >
> >> > >>>> >
> >> > >>>> > This is likely due to recent changes to the CMake Sphinx
> >> > >>>> configuration, that
> >> > >>>> > would require at least re-configuring CMake but likely require
> >> > >>>> removing the
> >> > >>>> > build cache and reconfiguring it all together.
> >> > >>>> > Ideally the script would re-configure CMake every time it runs to
> >> > >>>> prevent
> >> > >>>> > this sort of problem in the future.
> >> > >>>> >
> >> > >>>> > /Eric
> >> > >>>> >
> >> > >>>> > _______________________________________________
> >> > >>>> > LLVM Developers mailing list
> >> > >>>> > llvm-dev at lists.llvm.org
> >> > >>>> > http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev
> >> > >>>> >
> >> > >>>>
> >> > >>>>
> >> > >>>>
> >> > >>>> --
> >> > >>>> With best regards, Anton Korobeynikov
> >> > >>>> Department of Statistical Modelling, Saint Petersburg State University
> >> > >>>>
> >> > >>>
> >> > >>>
> >> > >>
> >> > >
> >> > >
> >> > _______________________________________________
> >> > cfe-dev mailing list
> >> > cfe-dev at lists.llvm.org
> >> > http://lists.llvm.org/cgi-bin/mailman/listinfo/cfe-dev
> > 
> _______________________________________________
> LLVM Developers mailing list
> llvm-dev at lists.llvm.org
> http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev



More information about the cfe-dev mailing list