New C++ Api: Initial setup of Api documentation. (#6295)
authorAina Niemetz <aina.niemetz@gmail.com>
Wed, 7 Apr 2021 19:15:31 +0000 (12:15 -0700)
committerGitHub <noreply@github.com>
Wed, 7 Apr 2021 19:15:31 +0000 (19:15 +0000)
commit887a75715761767bb7fd7b1d71e188399a4edd3b
treeaf6e47920d9443915ba8a97d12c7607a3ca7759c
parent04a494e251a8cc2c90bb429e2858f1c4eb8f88ff
New C++ Api: Initial setup of Api documentation. (#6295)

This configures the initial setup for generating Api documentation with
Sphinx via Breathe and Doxygen. All fixes in the documentation of the
cvc5.h header are for the purpose of eliminating warnings. This PR does
not check for completeness of the documentation, and does not yet tweak
the documentation to be nice, beautiful and consistent, which is
postponed to future PRs.

Configure with `--docs`, and then make. This will generate a `docs`
directory in the build directory. The Sphinx documentation can be found
at `build/docs/sphinx/index.html`. Doxygen documentation is only
generated as xml under `build/docs/doxygen`.

This PR further proposes a new style for copyright headers. If this
style is approved, I will submit a PR to update the update_copyright.pl
script.
CMakeLists.txt
INSTALL.md
cmake/FindSphinx.cmake [new file with mode: 0644]
configure.sh
docs/CMakeLists.txt [new file with mode: 0644]
docs/Doxyfile.in [new file with mode: 0644]
docs/conf.py [new file with mode: 0644]
docs/index.rst [new file with mode: 0644]
src/api/cpp/cvc5.cpp
src/api/cpp/cvc5.h
src/api/cpp/cvc5_kind.h