libweston/log: Add 'wlog' group for weston_log() related functions

This allows a better integration with the documentation of logging
framework.

Signed-off-by: Marius Vlad <marius.vlad@collabora.com>
dev
Marius Vlad 5 years ago
parent 8b8b803a46
commit 35ff4a8de5
  1. 3
      include/libweston/libweston.h
  2. 38
      libweston/log.c

@ -1812,6 +1812,9 @@ weston_compositor_set_xkb_rule_names(struct weston_compositor *ec,
/* String literal of spaces, the same width as the timestamp. */ /* String literal of spaces, the same width as the timestamp. */
#define STAMP_SPACE " " #define STAMP_SPACE " "
/**
* \ingroup wlog
*/
typedef int (*log_func_t)(const char *fmt, va_list ap); typedef int (*log_func_t)(const char *fmt, va_list ap);
void void
weston_log_set_handler(log_func_t log, log_func_t cont); weston_log_set_handler(log_func_t log, log_func_t cont);

@ -36,10 +36,23 @@
#include <libweston/libweston.h> #include <libweston/libweston.h>
/**
* \defgroup wlog weston-logging
*/
static int static int
default_log_handler(const char *fmt, va_list ap); default_log_handler(const char *fmt, va_list ap);
/** Needs to be set, defaults to default_log_handler
*
* \ingroup wlog
*/
static log_func_t log_handler = default_log_handler; static log_func_t log_handler = default_log_handler;
/** Needs to be set, defaults to default_log_handler
*
* \ingroup wlog
*/
static log_func_t log_continue_handler = default_log_handler; static log_func_t log_continue_handler = default_log_handler;
/** Sentinel log message handler /** Sentinel log message handler
@ -51,6 +64,8 @@ static log_func_t log_continue_handler = default_log_handler;
* *
* \param fmt The format string. Ignored. * \param fmt The format string. Ignored.
* \param ap The variadic argument list. Ignored. * \param ap The variadic argument list. Ignored.
*
* \ingroup wlog
*/ */
static int static int
default_log_handler(const char *fmt, va_list ap) default_log_handler(const char *fmt, va_list ap)
@ -71,6 +86,8 @@ default_log_handler(const char *fmt, va_list ap)
* when \a weston_log_continue is called, and should append * when \a weston_log_continue is called, and should append
* its output to the current line, without any header or * its output to the current line, without any header or
* other content in between. * other content in between.
*
* \ingroup wlog
*/ */
WL_EXPORT void WL_EXPORT void
weston_log_set_handler(log_func_t log, log_func_t cont) weston_log_set_handler(log_func_t log, log_func_t cont)
@ -79,12 +96,25 @@ weston_log_set_handler(log_func_t log, log_func_t cont)
log_continue_handler = cont; log_continue_handler = cont;
} }
/** weston_vlog calls log_handler
* \ingroup wlog
*/
WL_EXPORT int WL_EXPORT int
weston_vlog(const char *fmt, va_list ap) weston_vlog(const char *fmt, va_list ap)
{ {
return log_handler(fmt, ap); return log_handler(fmt, ap);
} }
/** printf() equivalent in weston compositor.
*
* \rststar
* .. note::
*
* Needs :var:`log_handler` to be set-up!
* \endrststar
*
* \ingroup wlog
*/
WL_EXPORT int WL_EXPORT int
weston_log(const char *fmt, ...) weston_log(const char *fmt, ...)
{ {
@ -98,12 +128,20 @@ weston_log(const char *fmt, ...)
return l; return l;
} }
/** weston_vlog_continue calls log_continue_handler
*
* \ingroup wlog
*/
WL_EXPORT int WL_EXPORT int
weston_vlog_continue(const char *fmt, va_list argp) weston_vlog_continue(const char *fmt, va_list argp)
{ {
return log_continue_handler(fmt, argp); return log_continue_handler(fmt, argp);
} }
/** weston_log_continue
*
* \ingroup wlog
*/
WL_EXPORT int WL_EXPORT int
weston_log_continue(const char *fmt, ...) weston_log_continue(const char *fmt, ...)
{ {

Loading…
Cancel
Save