forked from enlightenment/efl
eina: enhance doxygen for eina_counter.h
Summary: Arrange grouping Add @brief for brief description Add @details for detailed description Add [in] & [out] for parameters Fix indentation & Fix typeof Reviewers: raster, cedric Subscribers: cedric Differential Revision: https://phab.enlightenment.org/D1579 Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>
This commit is contained in:
parent
5a9d8d6f03
commit
be9390ce8b
|
@ -22,20 +22,21 @@
|
||||||
#include "eina_types.h"
|
#include "eina_types.h"
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @addtogroup Eina_Counter_Group Counter
|
* @defgroup Eina_Counter_Group Counter
|
||||||
|
* @ingroup Eina_Tools_Group
|
||||||
*
|
*
|
||||||
* @brief These functions allow you to get the time spent in a part of a code.
|
* @brief This group discusses the functions that allow you to get the time spent in a part of a code.
|
||||||
*
|
*
|
||||||
* Before using the counter system, Eina must be initialized with
|
* Before using the counter system, Eina must be initialized with
|
||||||
* eina_init() and later shut down with eina_shutdown(). The create a
|
* eina_init() and later shut down with eina_shutdown(). To create a
|
||||||
* counter, use eina_counter_new(). To free it, use
|
* counter, use eina_counter_new(). To free it, use
|
||||||
* eina_counter_free().
|
* eina_counter_free().
|
||||||
*
|
*
|
||||||
* To time a part of a code, call eina_counter_start() just before it,
|
* To time a part of a code, call eina_counter_start() just before it,
|
||||||
* and eina_counter_stop() just after it. Each time you start to time
|
* and eina_counter_stop() just after it. Each time you start to time
|
||||||
* a code, a clock is added to a list. You can give a number of that
|
* a code, a clock is added to a list. You can give the number of that
|
||||||
* clock with the second argument of eina_counter_stop(). To send all
|
* clock with the second argument of eina_counter_stop(). To send all
|
||||||
* the registered clocks to a stream (like stdout, ofr a file), use
|
* the registered clocks to a stream (like stdout, for a file), use
|
||||||
* eina_counter_dump().
|
* eina_counter_dump().
|
||||||
*
|
*
|
||||||
* Here is a straightforward example:
|
* Here is a straightforward example:
|
||||||
|
@ -86,37 +87,27 @@
|
||||||
* }
|
* }
|
||||||
* @endcode
|
* @endcode
|
||||||
*
|
*
|
||||||
* Compile this code with the following commant:
|
* Compile this code with the following command:
|
||||||
*
|
*
|
||||||
* @verbatim
|
* @verbatim
|
||||||
* gcc -Wall -o test_eina_counter test_eina.c `pkg-config --cflags --libs eina`
|
* gcc -Wall -o test_eina_counter test_eina.c `pkg-config --cflags --libs eina`
|
||||||
* @endverbatim
|
* @endverbatim
|
||||||
*
|
*
|
||||||
* The result should be something like that:
|
* The result should be something like this:
|
||||||
*
|
*
|
||||||
* @verbatim
|
* @verbatim
|
||||||
* \# specimen experiment time starting time ending time
|
* \# specimen experiment time starting time ending time
|
||||||
* 1 9794125 783816 10577941
|
* 1 9794125 783816 10577941
|
||||||
* @endverbatim
|
* @endverbatim
|
||||||
*
|
*
|
||||||
* @note The displayed time is in nanosecond.
|
* @note The displayed time is in nanoseconds.
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @addtogroup Eina_Tools_Group Tools
|
|
||||||
*
|
|
||||||
* @{
|
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @defgroup Eina_Counter_Group Counter
|
|
||||||
*
|
*
|
||||||
* @{
|
* @{
|
||||||
*/
|
*/
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef Eina_Counter
|
* @typedef Eina_Counter
|
||||||
* Counter type.
|
* @brief Type for Counter.
|
||||||
*/
|
*/
|
||||||
typedef struct _Eina_Counter Eina_Counter;
|
typedef struct _Eina_Counter Eina_Counter;
|
||||||
|
|
||||||
|
@ -201,10 +192,6 @@ EAPI void eina_counter_stop(Eina_Counter *counter,
|
||||||
*/
|
*/
|
||||||
EAPI char *eina_counter_dump(Eina_Counter *counter) EINA_ARG_NONNULL(1);
|
EAPI char *eina_counter_dump(Eina_Counter *counter) EINA_ARG_NONNULL(1);
|
||||||
|
|
||||||
/**
|
|
||||||
* @}
|
|
||||||
*/
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @}
|
* @}
|
||||||
*/
|
*/
|
||||||
|
|
Loading…
Reference in New Issue