Reformat doc comments

Unify the way we document our APIs. See CONTRIBUTING.md for the
rules.
This commit is contained in:
Simon Ser 2022-05-24 18:46:59 +02:00 committed by Simon Zeni
parent 27383a1929
commit 28d89779af
65 changed files with 399 additions and 372 deletions

View file

@ -32,13 +32,20 @@ enum wlr_log_importance {
typedef void (*wlr_log_func_t)(enum wlr_log_importance importance,
const char *fmt, va_list args);
// Will log all messages less than or equal to `verbosity`
// If `callback` is NULL, wlr will use its default logger.
// The function can be called multiple times to update the verbosity or
// callback function.
/**
* Set the log verbosity and callback.
*
* Only messages less than or equal to the supplied verbosity will be logged.
* If the callback is NULL, the default logger is used.
*
* This function can be called multiple times to update the verbosity or
* callback function.
*/
void wlr_log_init(enum wlr_log_importance verbosity, wlr_log_func_t callback);
// Returns the log verbosity provided to wlr_log_init
/**
* Get the current log verbosity configured by wlr_log_init().
*/
enum wlr_log_importance wlr_log_get_verbosity(void);
#ifdef __GNUC__