]> git.ipfire.org Git - thirdparty/bind9.git/commit
Use separate sphinx-build cache directories
authorMichał Kępień <michal@isc.org>
Wed, 3 Feb 2021 10:44:02 +0000 (11:44 +0100)
committerMichał Kępień <michal@isc.org>
Wed, 3 Feb 2021 10:44:02 +0000 (11:44 +0100)
commit33db7ea16d630b3fcc756c704b1a91ae887019f4
tree45b5786685924b567117a8ea1db5b6d16c619920
parent62af115fa954c5ecef2d97cbea1e6b43574b8617
Use separate sphinx-build cache directories

Simultaneously starting multiple sphinx-build instances with the -d
command line switch set to a common value (which is what happens when
e.g. "make -j6 doc" is run) causes intermittent problems which we failed
to notice before because they only trigger Sphinx warnings, not errors,
e.g.:

    WARNING: toctree contains ref to nonexisting file 'reference'

The message above is not triggered because doc/arm/reference.rst is
actually missing from disk at any point, but rather because a temporary
file created by one sphinx-build instance gets truncated by another one
working in parallel (the confusing message quoted above is logged
because of an overly broad "except" statement in Sphinx code).

Prevent this problem from being triggered by making each sphinx-build
process use its own dedicated cache directory.
doc/arm/Makefile.am
doc/man/Makefile.am