If anybody ever reads this, one way to test exhale is generate the full api and track it on git (you can force-push this away, or do it on a different branch altogether and kill that branch).
Suppose you got
docs/
api/
library_root.rst and all the others
doxyoutput/
conf.py
Then you want to locally make html once. Now git add -Af api/ doxyoutput so that all the generated reStructuredText and doxygen files are going to be available in a clone. Now edit conf.py and comment out the exhale entry in extensions and anything else exhale related (don't forget to git add conf.py changes).
Hopefully you shouldn't need to do this, but it can help identify where the problem is. In this case, doing that produced a successful build, so clearly exhale is the problem!
It seems that medium to large projects cause problems on RTD.
/dev/null
on RTDThe hacky
silent
branch verified that exhale is the cause ofcat conf.py
being the last step before failure.If anybody ever reads this, one way to test
exhale
is generate the full api and track it on git (you can force-push this away, or do it on a different branch altogether and kill that branch).Suppose you got
Then you want to locally
make html
once. Nowgit add -Af api/ doxyoutput
so that all the generated reStructuredText and doxygen files are going to be available in aclone
. Now editconf.py
and comment out theexhale
entry inextensions
and anything elseexhale
related (don't forget togit add conf.py
changes).Hopefully you shouldn't need to do this, but it can help identify where the problem is. In this case, doing that produced a successful build, so clearly
exhale
is the problem!