llvm dev - May 2017 - www-scripts Sphinx doc builder broken and needs intervention.

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
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20170509/0fd05489/attachment.html>

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

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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://lists.llvm.org/pipermail/llvm-dev/attachments/20170510/10f79e42/attachment.html>