[openstack-dev] [all] Sphinx 'doctrees' bug recently resolved

Stephen Finucane sfinucan at redhat.com
Wed Sep 26 10:41:30 UTC 2018

FYI, Sphinx 1.8.0 contained a minor issue (introduced by yours truly)
which resulted in an incorrect default doctree directory [1]. This
would manifest itself in a 'docs/source/.doctree' directory being
created and would only affects projects that call 'sphinx-build' from
tox without specifying the '-d' parameter.

This has been fixed in Sphinx 1.8.1. I don't think it's a significant
enough issue to blacklist the 1.8.0 version and if you were seeing
issues with this in recent weeks, the issue should now be resolved. You
can still merge patches which explicitly set the '-d' parameter but
they should be unnecessary now.


[1] https://github.com/sphinx-doc/sphinx/issues/5418

More information about the OpenStack-dev mailing list