Various improvements to documentation (#7283)
authorGereon Kremer <nafur42@gmail.com>
Mon, 4 Oct 2021 20:59:28 +0000 (13:59 -0700)
committerGitHub <noreply@github.com>
Mon, 4 Oct 2021 20:59:28 +0000 (20:59 +0000)
commit3630215cc02f7243fccba0a8078dd251a252abdc
tree98950d44590fe6e983c9bb2934505b4224121b86
parent3279dca5b019f67cbb26be2fb146f2e82a674123
Various improvements to documentation (#7283)

This PR adds a couple of improvements to our documentation setup
- add an explicit dependency on the extension so that sphinx rebuilds pages appropriately when an extension is modified
- sphinx now emits warnings for examples that are not implemented in all languages (smt2, cpp, java and python)
- add -v to make the sphinx output more log-file friendly
- avoid a warning when the java bindings (and thus java docs) are not build
- replace file(WRITE by configure_file to avoid rather common erroneous rebuilds of python docs
- fix a reference to a label in the python docs
- suppress timestamps in javadoc output to avoid docs-ci being triggered for every PR
- improve placeholder message when java bindings are disabled
docs/CMakeLists.txt
docs/api/java/CMakeLists.txt
docs/api/java/index.rst
docs/conf.py.in
docs/ext/examples.py
docs/ext/include_build_file.py
src/api/python/CMakeLists.txt
src/api/python/__init__.py.in [new file with mode: 0644]
src/api/python/cvc5.pxi