1 files changed, 12 insertions, 5 deletions
diff --git a/include/wlr/util/log.h b/include/wlr/util/log.h
index aacdea99..5e5d8393 100644
--- a/include/wlr/util/log.h
+++ b/include/wlr/util/log.h
@@ -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__