This section contains instructions on how to use Doxygen with Drake.
Doxygen Style Guide
Classes that implement the drake::systems::System interface should add a
simple diagram documenting their input and output ports using the custom doxygen-style
@system name: Alchemist input_ports: - lead - more lead output_ports: - gold @endsystem
The text between these tags is parsed as YAML, and must define the key
and may optionally define the lists
values may include
html code. The class name appears in the inside of the
rendered system block, you can get creative and add an image, or you can adjust
the text colors of your ports.
Some systems have variable numbers of ports, or ports that are created
conditionally. Prefer to add all possible ports to the diagram; see the Adder
system for an example of a system with a variable number of ports. The
@system/@endsystem tags can be used multiple times to add multiple renders
of the system to the documentation, if the system is most clearly described by a
Documentation Tips and Tricks
We encourage the use of unicode in documentation.
For documenting block diagrams, consider using ascii art. See, for instance,
Doxygen Website Generation
To generate and view Drake’s Doxygen website, see: Documentation Instructions.