It says "config changed", which means that Sphinx believes that something
in your `conf.py` file has changed. There are a few ways this can happen.
The first is that you actually changed some value in `conf.py`, but it
sounds like this is not it.
The next is that something in your `conf.py` that ends up in the env config
does not have a stable `repr`. For example, in sphinx-gallery for a while
we had things where people could pass in functions, like in `conf.py` they
could pass a callable like (simplified):
sphinx_gallery_conf = {
'something': lambda x: x * 2,
}
And this ended up in the env config. However, functions in general (lambdas
included) do not have stable `repr`s, so Sphinx would detect a `conf.py`
change despite the file not actually changing, because the `repr` of the
`lambda` would contain a random memory address each run. Hence the warning
we added in sphinx-gallery here
<https://sphinx-gallery.github.io/configuration.html#sorting-gallery-subsections>
.
Then in numpydoc Sphinx extension we had a problem (that I introduced!)
where we updated the config vars during the run to include some reasonable
defaults. Sphinx stores/pickles the values at the *end* of the run, but on
subsequent runs checks the values at the *beginning* of the run to see if
they have changed to decide if the config has changed, so our modification
in the middle caused a full rebuild to happen every time. This was fixed in
numpydoc by not modifying the env config values that were there at the
start of the run.
There might be other ways, too, but these are the "gotcha"s I've hit.
For what it's worth, on the branch from this PR the config var that
actually causes the problem should actually be reported, you could give it
a shot:
https://github.com/sphinx-doc/sphinx/pull/6419#issuecomment-503299555
You can probably install with some variant of:
pip install "https://api.github.com/repos/larsoner/sphinx/zipball/config";
HTH,
Eric
On Wed, Aug 7, 2019 at 3:16 PM Tzach Livyatan <[email protected]> wrote:
> Hi all
> As the subject says, sphinx-build started to update all files, on every
> run. I suspect it started when I moved to from Sphinx 1.6 to 1.8, but I'm
> not sure
> Any idea?
>
> Thanks
> Tzach
>
> Example output below
>
>
> $ make preview
> bin/sphinx-build -b dirhtml -d _build/doctrees . _build/dirhtml
> Running Sphinx v1.8.5
> loading pickled environment... done
> building [mo]: targets for 0 po files that are out of date
> building [dirhtml]: targets for 6 source files that are out of date
> updating environment: [config changed] 413 added, 1 changed, 0 removed
> reading sources... [100%] using-scylla/workload-prioritization
>
>
> looking for now-outdated files... none found
> pickling environment... done
> checking consistency... done
> preparing documents... done
> writing output... [100%]
>
>
> generating indices... genindex
> writing additional pages... search
> copying images... [100%]
>
> copying static files... done
> copying extra files... done
> dumping search index in English (code: en) ... done
> dumping object inventory... done
> build succeeded.
>
>
>
> --
> You received this message because you are subscribed to the Google Groups
> "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/sphinx-users/5c1a8db3-94d4-4de0-8d9b-39653c39535c%40googlegroups.com
> <https://groups.google.com/d/msgid/sphinx-users/5c1a8db3-94d4-4de0-8d9b-39653c39535c%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>
--
You received this message because you are subscribed to the Google Groups
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/sphinx-users/CAGu2niXOUjsLwHHvKNNH7vMqk%2B%3DGQKe3YqQyRweshLGrryxvWw%40mail.gmail.com.
