summaryrefslogtreecommitdiff
path: root/docs
AgeCommit message (Collapse)Author
2021-10-11Add CI workflow to test different cmake versions (#7254)Gereon Kremer
This refactors the CI setup by moving parts of the CI workflow into new composite actions. This allows to reuse this parts in a new workflow that tests against many different cmake versions. It is mostly useful after modifying our cmake setup to check compatibility with older cmake versions. The workflow is not triggered automatically, but can be started manually.
2021-10-07Add a binary / SMT-LIB quickstart (#7315)Gereon Kremer
This PR adds a binary/SMT-LIBv2 quickstart example, based on the cpp quickstart example.
2021-10-07Replace doubles by rationals in C++ quickstart (#7317)Gereon Kremer
This PR removes the conversion of rationals to double in favour of properly handling them as rationals (as pairs of integers) in the C++ quickstart example.
2021-10-06Remove timestamped javadoc comments (#7304)Gereon Kremer
This PR also removes the javadoc timestamps from index.html, which for some reason does not honor the -notimestamp option.
2021-10-04Add sygus examples to documentation (#7303)Gereon Kremer
For some reason, we didn't have any SMT-LIB (or rather SyGuS) example files for the SyGuS examples yet. This PR adds these missing examples.
2021-10-04Various improvements to documentation (#7283)Gereon Kremer
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
2021-10-04No longer build docs by default. Use make docs. (#7296)Gereon Kremer
This PR changes our policy when to build the documentation. Beforehand, make docs was included in make and make all. Now, you need to run make docs explicitly.
2021-10-01Update java examples using the new Java API (#7225)mudathirmahgoub
This PRs updates java examples using the new Java API, by converting C++ examples to Java. Examples CVC4Streams.java and PipedInput.java are removed since they are not longer supported by the API. All examples are not included in the build which would be added in a future PR.
2021-09-30Integrate javadoc documentation (#7278)Gereon Kremer
This PR adds the cmake setup to generate javadoc documentation for the java API and integrates it into the sphinx documentation. Right now, we simply link to the javadoc. This PR also modifies a bunch of javadoc comments to use proper javadoc syntax.
2021-09-20Start python API Solver documentation (#7064)Alex Ozdemir
2021-08-30Add API function to obtain information about a single option (#6980)Gereon Kremer
This PR adds api::Solver::getOptionInfo() that returns information about a single option, including its name, aliases, current and default value and its domain.
2021-08-30python docs for Datatype-related classes (#7058)yoni206
2021-08-19Add python quick start guide (#7024)yoni206
2021-07-29Integrate installation instructions into documentation (#6814)Gereon Kremer
This PR migrates the current INSTALL.md to an rst file and then includes it in the documentation. It also does some minor improvements to this file, in particular it now mentions --dep-path
2021-07-29quickstart: Add python example to docs. (#6949)Aina Niemetz
2021-07-28Print link to docs preview (#6922)Andres Noetzli
This commit adds a message to the `docs` target with a link to a preview of the documentation, e.g.: ``` Preview docs in browser: file://localhost/home/noetzli/repos/cvc5_win/build-docs/docs/sphinx/index.html ```
2021-07-06Porting C++ API examples to SMT-LIB examples (#6789)Haniel Barbosa
SyGuS examples will come later.
2021-07-05Add doc page about transcendentals (#6755)Gereon Kremer
This PR adds a theory reference page for the transcendental extension.
2021-07-02Refactor lexer for SMT-LIB in sphinx (#6805)Gereon Kremer
This PR refactors the lexer used by sphinx for highlighting SMT-LIB files. This new lexer properly checks for word boundaries and uses the proper character sets from the SMT-LIB standard.
2021-06-24api: getRealValue: Fix printing of integer values. (#6795)Aina Niemetz
2021-06-23docs: Add quickstart guide. (#6782)Aina Niemetz
2021-06-21docs: Split out and merge C++ class hierarchy. (#6781)Aina Niemetz
This restructures the entry page for the C++ API documentation in preparation for adding a quickstart and linking to examples and adding more content.
2021-06-19docs: Fix config to produce unique Sphinx section labels. (#6767)Aina Niemetz
2021-06-18docs: Remove 'View page source' link in right corner. (#6771)Aina Niemetz
We don't upload the source files to the website, so this will always be a 404.
2021-06-15docs: Fix reference in sep logic reference. (#6747)Aina Niemetz
2021-06-15docs: Add references instead of links in theory reference pages. (#6729)Aina Niemetz
2021-06-09docs: Migrate sets and relations theory reference. (#6698)Aina Niemetz
This migrates page https://cvc4.github.io/sets-and-relations. It further adds the SMT2 version of examples/api/cpp/sets.cpp and adds test/regress/regress0/rels/relations-ops.smt2 as smtlib example for relations.
2021-06-09docs: Migrate separation logic theory reference. (#6702)Aina Niemetz
This migrates page https://cvc4.github.io/separation-logic.
2021-06-09docs: Fix `Kind` description (#6712)Andres Noetzli
This commit changes the Kind description not to include C/C++ preprocessor statements and updates the kind of bit-vector addtion. It also marks some of the information as internal to exclude it from the public documentation.
2021-06-04docs: Migrate datatypes theory reference. (#6662)Aina Niemetz
This migrates https://cvc4.github.io/datatypes.
2021-06-01docs: Migrate input languages page. (#6659)Aina Niemetz
This migrates page https://cvc4.github.io/input-languages.
2021-06-01docs: Restructure index page, fix style issue. (#6657)Aina Niemetz
2021-05-26Add more examples to the documentation (#6569)Gereon Kremer
This PR adds (most of) the existing examples to the documentation, and does some other minor updates on the documentation. Some details: - for consistency, all cpp examples are moved from examples/api to examples/api/cpp - add capabilities for SMT-LIB examples, and two simple smt2 examples - more docs/examples/*.rst files - two new documentation categories: installation (how to obtain, compile and install cvc5) and binary (about the cvc5 binary)
2021-05-26Reduce size of sphinx-gh output (#6601)Gereon Kremer
This PR reduces the disk size of the docs generated by make sphinx-gh. Apart from reformatting the cmake source, we now not only remove the _sources folder, but also .doctrees (essentially the sphinx cache) and _static/fonts/ (the fonts that are actually used live in _static/css/fonts). In combination, this now reduces the disk size from about 20MB (sphinx) to less than 6MB (sphinx-gh). Furthermore this PR only uploads the generated documentation if it differs from whatever we currently have for master. This is relevant to make the docs-ci repository smaller (which already has more than 5GB...)
2021-05-25api docs: Fix and tweak style for home and top links. (#6618)Aina Niemetz
2021-05-21api docs: Tweak and fix style. (#6582)Aina Niemetz
This fixes the style for narrow layouts. It further fixes and improves the style for the menu.
2021-05-21api docs: Update copyright. (#6596)Aina Niemetz
2021-05-20Minor improvements to the API (#6585)Gereon Kremer
This PR does some minor improvements to the API: - remove getConstSequenceElements(), use getSequenceValue() instead - improve documentation for Term
2021-05-19Generate command line options for sphinx docs (#6555)Gereon Kremer
This PR adds documentation about the command line options to the sphinx documentation. It is mostly a reformatted version of what --help would print.
2021-05-13api docs: Tweak style to be consistent with website style. (#6537)Aina Niemetz
2021-05-04Improve generation of python API documentation (#6482)Gereon Kremer
This PR makes generating the python part of our API documentation more reliable. If python bindings are enabled, it makes the docs target depend on pycvc5 and renders a warning into the documentation if python bindings are disabled. To make the dependency on pycvc5 work properly, it changes the python bindings build so that the library is directly put in the right place and avoid the manual rename, so that the pycvc5 target actually points to the correct file. Unfortunately, this means we need to build libcvc5 when building docs with python bindings enabled.
2021-04-27Initial setup for docs of python API (#6445)Gereon Kremer
This PR adds the basic setup for including the python API in our sphinx documentation and shows how it works using the Datatype class as an example. In detail - it enables sphinx.ext.autodoc and makes sure the generated pycvc5 is in the search path - adds a index page for the python API - adds a page for the Datatype class - adds docstrings for the Datatype class - does some finetuning (remove source locations, but adds signature information)
2021-04-27Use std::hash for API types (#6432)Gereon Kremer
This PR replaces all api::*HashFunction objects by specializations of std::hash. std::hash is meant to be extended in this way, and it allows for a much cleaner usage of std::unordered_set and std::unordered_map with these types.
2021-04-26Generate docs conf.py by cmake (#6441)Gereon Kremer
This PR makes cmake generate the sphinx configuration file. This will simplify dynamically modifying this file in the future, for example to add custom paths within the build directory (for the python API).
2021-04-22Add API documentation for statistics (#6364)Gereon Kremer
This PR adds documentation for api::Statistics and api::Stat, as well as further explanations in sphinx. It also adds a custom css to our sphinx theme that slightly changes how inline code blocks look.
2021-04-22api docs: Rename doxygen output directory. (#6426)Aina Niemetz
2021-04-22api docs: Remove file reintroduced in past merge. (#6426)Aina Niemetz
2021-04-21Goodbye CVC4, hello cvc5! (#6371)Mathias Preiner
This commits changes the build system to cvc5 and removes the remaining occurrences of CVC4. It further cleans up outdated/unused scripts in contrib/.
2021-04-21cmake: Add optional module name argument for check_python_module helper. (#6406)Mathias Preiner
Addtionally adds checks for required documentation modules.
2021-04-20Split C++ API docs from general docs (#6365)Gereon Kremer
generated by cgit on debian on lair
contact matthew@masot.net with questions or feedback