Doxygen

From miki
Revision as of 23:44, 18 February 2021 by Mip (talk | contribs) (→‎Format)
Jump to navigation Jump to search

Reference

Reference

One-liner

Documentation block are usually added before the item to document. Use /** ... */ or ///:

/** Brief description which ends at this dot. Details follow
 *  here.
 */
uint8_t my_int;

/// Brief description which ends at this dot. Details follow
/// here.
uint8_t my_other_int;

Documentation can also be added after members.

int var; /*!< Detailed description after the member */ 

int var; /**< Detailed description after the member */

int var; //!< Detailed description after the member
         //!< 

int var; ///< Detailed description after the member
         ///<

Most often one only wants to put a brief description after a member. This is done as follows:

int var; //!< Brief description after the member

int var; ///< Brief description after the member

Functions

Typical function comment block:

/** 
 * @brief Make coffee.
 * 
 * Brew coffee with the given beans.
 *
 * @param[in]  beans  Pointer to the bag of beans.
 * @param[in]  count Number of beans to take.
 * @param[out] pot   Pointer to the coffee pot, where coffee will be loaded.
 *
 * @return     The quantity of brewed coffee.
 */
int brew_coffee(void * beans, int count, void * pot);

Format

  • Use #variable to create a link to variable, or anything that can be referenced.
/** 
 * @param[in]  beans  Pointer to the bag of beans.
 * @param[in]  count  Number of #beans to take.
 */

Tips

Link to Main Page

Use /ref index [1]:

/**
 * See \ref index.
 */