Generate API docs from source

The API reference docs for C++ are already pre-generated. If you still would like to generate them, you find the instructions to do so below.

Build API Reference Documentation

The C++ source code is annotated using comments using Doxygen syntax.

Extract the documentation to markdown files (one per class) on macOS or Linux using the commands:

rm -rf tools/docs # Remove previous docs
./tools/generate_docs.sh

The files are created in /install/docs/markdown.

INFO

Extracting the API reference does not yet work automatically on Windows.

INFO

The generate_docs.sh script copies the public headers to /install/include/mavsdk, the same layout they are installed with, and then uses DOxygen to create XML documentation in /install/docs/xml. The generate_markdown_from_doxygen_xml.py script is then run on all files in the /xml directory to generate markdown files in /install/docs/markdown.