-
Notifications
You must be signed in to change notification settings - Fork 6
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"
Copyright (c) 2016, Xerox Corporation (Xerox) and Palo Alto Research Center (PARC). All rights reserved.