How to use Doxygen to generate documentation for our code

From KratosWiki
Revision as of 08:48, 26 January 2011 by Jcotela (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This How To introduces the Doxygen documentation system and gives some guidelines to use it to document Kratos code


What is Doxygen?

Doxygen is system that can be used to produce documentation for our code. It reads our source code looking for comments that follow a special format, and uses that information to generate our documentation.

Basic instructions to document C++ code

Doxygen allows

Class documentation: Short description and long description

Function documentation

Other useful commands

Grouping into modules

The todo list

Documenting Kratos classes

Using the header templates

What to document?

Our aim for Kratos would be, at least, having a complete documentation for all classes and public methods

Personal tools