From 2c4d8d1ae22515cbf1a5fdb48cbe1f90d13d5a3f Mon Sep 17 00:00:00 2001 From: Damon Chaplin Date: Sun, 11 Jun 2000 17:28:20 +0000 Subject: [PATCH] updated a few bits about log handlers & flags. 2000-06-11 Damon Chaplin * tmpl/messages.sgml: updated a few bits about log handlers & flags. --- docs/reference/ChangeLog | 4 ++++ docs/reference/glib/glib/ChangeLog | 4 ++++ docs/reference/glib/tmpl/messages.sgml | 19 ++++++++++++++++--- 3 files changed, 24 insertions(+), 3 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 2cf0ed2..cfad12b 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,7 @@ +2000-06-11 Damon Chaplin + + * tmpl/messages.sgml: updated a few bits about log handlers & flags. + 2000-04-16 Damon Chaplin * tmpl/linked_lists_single.sgml: diff --git a/docs/reference/glib/glib/ChangeLog b/docs/reference/glib/glib/ChangeLog index 2cf0ed2..cfad12b 100644 --- a/docs/reference/glib/glib/ChangeLog +++ b/docs/reference/glib/glib/ChangeLog @@ -1,3 +1,7 @@ +2000-06-11 Damon Chaplin + + * tmpl/messages.sgml: updated a few bits about log handlers & flags. + 2000-04-16 Damon Chaplin * tmpl/linked_lists_single.sgml: diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml index 536b8e3..5fd382d 100644 --- a/docs/reference/glib/tmpl/messages.sgml +++ b/docs/reference/glib/tmpl/messages.sgml @@ -70,7 +70,8 @@ Specifies the prototype of log handler functions. @log_domain: the log domain of the message. -@log_level: the log level of the message. +@log_level: the log level of the message (including the fatal and recursion +flags). @message: the message to process. @user_data: user data, set in g_log_set_handler(). @@ -152,11 +153,23 @@ documentation. -Sets the log handler for a domain and set of log levels. +Sets the log handler for a domain and a set of log levels. +Note that to handle fatal and recursive messages the @log_levels parameter +must be combined with the G_LOG_FLAG_FATAL and G_LOG_FLAG_RECURSIVE bit flags. + + +Adding a log handler for all warning messages + + g_log_set_handler (NULL, G_LOG_LEVEL_WARNING | G_LOG_FLAG_FATAL + | G_LOG_FLAG_RECURSIVE, my_log_handler, NULL); + + @log_domain: the log domain, or NULL for the default "" application domain. -@log_levels: the levels to apply the log handler. +@log_levels: the log levels to apply the log handler for. To handle fatal +and recursive messages as well, comine the log levels with the G_LOG_FLAG_FATAL +and G_LOG_FLAG_RECURSIVE bit flags. @log_func: the log handler function. @user_data: data passed to the log handler. @Returns: the id of the new handler. -- 2.7.4