Fix doxygen warnings

This commit is contained in:
Nedko Arnaudov 2013-02-10 16:19:59 +02:00
parent 41c7c2d825
commit 74fbf510b9
1 changed files with 13 additions and 4 deletions

View File

@ -2,7 +2,7 @@
/* /*
* LADI Session Handler (ladish) * LADI Session Handler (ladish)
* *
* Copyright (C) 2009, 2010, 2011, 2012 Nedko Arnaudov <nedko@arnaudov.name> * Copyright (C) 2009, 2010, 2011, 2012, 2013 Nedko Arnaudov <nedko@arnaudov.name>
* *
************************************************************************** **************************************************************************
* This file contains interface to app supervisor object * This file contains interface to app supervisor object
@ -35,7 +35,7 @@
#define LADISH_APP_STATE_STOPPING 2 /**< @brief app is stopping */ #define LADISH_APP_STATE_STOPPING 2 /**< @brief app is stopping */
#define LADISH_APP_STATE_KILL 3 /**< @brief app is being force killed */ #define LADISH_APP_STATE_KILL 3 /**< @brief app is being force killed */
#define MAX_LEVEL_CHARCOUNT 12 /* includes terminating nul char */ #define MAX_LEVEL_CHARCOUNT 12 /**< @brief max size of level string, includes terminating nul char */
/** /**
* App supervisor object handle (pointer to opaque data) * App supervisor object handle (pointer to opaque data)
@ -74,6 +74,9 @@ typedef void (* ladish_app_supervisor_on_app_renamed_callback)(
* @param[in] level The level that app was started in * @param[in] level The level that app was started in
* @param[in] pid PID of the app; Zero if app is not started * @param[in] pid PID of the app; Zero if app is not started
* @param[in] uuid uuid of the app * @param[in] uuid uuid of the app
*
* @retval true Continue iteration
* @retval false Stop iteration
*/ */
typedef bool (* ladish_app_supervisor_enum_callback)( typedef bool (* ladish_app_supervisor_enum_callback)(
void * context, void * context,
@ -96,7 +99,7 @@ typedef void (* ladish_save_complete_callback)(void * context, bool success);
/** /**
* Check whether app level string is valid. * Check whether app level string is valid.
* *
* @param [in] app level string * @param [in] level app level string
* @param [out] len_ptr When not NULL, the pointed variable will receive length of the level string, excluding terminating nul char. * @param [out] len_ptr When not NULL, the pointed variable will receive length of the level string, excluding terminating nul char.
* *
* @return whether level string is valid * @return whether level string is valid
@ -166,7 +169,10 @@ ladish_app_supervisor_set_project_name(
* *
* @param[in] supervisor_handle supervisor object handle * @param[in] supervisor_handle supervisor object handle
* @param[in] pid pid of the app whose termination was detected * @param[in] pid pid of the app whose termination was detected
* @param[in] exit_statis process exit status as returned by waitpid() * @param[in] exit_status process exit status as returned by waitpid()
*
* @retval true Success
* @retval false Unknown pid
*/ */
bool bool
ladish_app_supervisor_child_exit( ladish_app_supervisor_child_exit(
@ -180,6 +186,9 @@ ladish_app_supervisor_child_exit(
* @param[in] supervisor_handle supervisor object handle * @param[in] supervisor_handle supervisor object handle
* @param[in] context User defined context to be supplied when the callback suppiled through the @c callback parameter is called * @param[in] context User defined context to be supplied when the callback suppiled through the @c callback parameter is called
* @param[in] callback Callback to call for each app * @param[in] callback Callback to call for each app
*
* @retval true All apps iterated
* @retval false Iteration stopped because callback returned false
*/ */
bool bool
ladish_app_supervisor_enum( ladish_app_supervisor_enum(