

See section Documentation at other places in the manual to learn more about structural commands. A structural command links a documentation block to a certain entity that can be documented (a function, member, variable, class, namespace or file).

The Getting started (Step 3) section of the Doxygen manual mentions the basic ways of documenting the sources.įor members, classes and namespaces there are basically two options: General workflow to produce source code documentation with Doxygen. Visit the source documentation page for instructions on building the FreeCAD documentation, which is also hosted online on the FreeCAD API website. This document gives a brief introduction to Doxygen, in particular how it is used in FreeCAD to document its sources.

Visit the Doxygen website to learn more about the system, and consult the Doxygen Manual for the full information. 8.5 Converting the comment style on the flyĭoxygen is a popular tool for generating documentation from annotated C++ sources it also supports other popular programming languages such as C#, PHP, Java, and Python.8.4 Converting the Pythonic style to Doxygen style.8.2 Second style: documentation block before the code.8.1 First style: Pythonic documentation.3.2 Second style: documentation block elsewhere.3.1 First style: documentation block before the code.
