]> git.notmuchmail.org Git - notmuch/commit
build/docs: move docstring prereq to file targets
authorDavid Bremner <david@tethera.net>
Thu, 10 Dec 2020 01:55:38 +0000 (21:55 -0400)
committerDavid Bremner <david@tethera.net>
Thu, 10 Dec 2020 01:55:38 +0000 (21:55 -0400)
commited7ca948ae31ac0e1d3633a2f58fb3e4aecd03de
tree84494458e6568b45d879d5b07a8014131bc15592
parent900ee94b0f4f48ee536bd2e9bd6bb2dfc661d615
build/docs: move docstring prereq to file targets

Under a sufficiently high level of parallelism [1] there seems to be a
a race condition that allows sphinx-build to start running before the
docstrings are extracted. This change moves the docstring stamp from
the phony targets sphinx-html and sphinx-info to the file targets that
they depend on. I'm not sure why this makes things better, but I am
fairly confident it does not make things worse, and experimentally it
seems to eliminate the race condition.

[1]: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=976934
doc/Makefile.local