The source tree for this recipe is similar to the two previous recipes:
.
├── cmake
│ ├── FindPythonModule.cmake
│ ├── FindSphinx.cmake
│ └── UseBreathe.cmake
├── CMakeLists.txt
├── docs
│ ├── code-reference
│ │ ├── classes-and-functions.rst
│ │ └── message.rst
│ ├── conf.py.in
│ ├── Doxyfile.in
│ └── index.rst
└── src
├── CMakeLists.txt
├── hello-world.cpp
├── Message.cpp
└── Message.hpp
The docs subdirectory now contains both a Doxyfile.in and a conf.py.in template file, with settings for Doxygen and Sphinx, respectively. In addition, we also have a code-reference subdirectory.
The files following code-reference contain Breathe instructions, to include Doxygen-generated documentation in Sphinx:
Messaging classes
=================
Message
-------
.. doxygenclass:: Message
:project: recipe-03
:members:
:protected-members:
:private-members:
This will output the documentation for the Message class.