Skip to content

Header doc format

Marc Mosko edited this page Mar 2, 2016 · 8 revisions

Class headers

/**
* @ingroup <Group related classes together>
*
* <Class description>
*/

Method headers

/*
* <Description>
*
* @param [in] <Input parameter description>
* @param [in] <Input parameter description>
*
* @return 0 <Output value and description>
* @return -1 <Output value and description>
*
* Example:
* @code
* {
* <Code example snippet>
* }
* @endcode
*
* @see <Related methods>
*/

Others (#define/enum/typedef)

/**
* <single line description>
*
* <Detailed paragraph description if needed>
*/

Notes:

  • Don't use @brief or @abstract or @discussion anywhere
  • For descriptions of variables, use the multi-line comment as shown above in "Others"
  • Home
  • [Getting Started](Getting Started)
  • Developer
    • [Node Architecture](Node Architecture)
    • [Header doc format](Header doc format)
    • [Unit Tests](Unit Tests)
    • [Overriding Implementations](Overriding Implementations)
    • [Code Coverage](Code Coverage)
Clone this wiki locally