improve g_log_set_handler docs

2001-12-06  Havoc Pennington  <hp@redhat.com>

	* glib/tmpl/messages.sgml: improve g_log_set_handler docs

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index ad6c40d..82a955d 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,7 @@
+2001-12-06  Havoc Pennington  <hp@redhat.com>
+
+       * glib/tmpl/messages.sgml: improve g_log_set_handler docs
+
 Wed Nov 28 18:50:19 2001  Owen Taylor  <otaylor@redhat.com>
 
        * glib/glib-sections.txt: Update.

diff --git a/docs/reference/glib/tmpl/messages.sgml b/docs/reference/glib/tmpl/messages.sgml
index 7a05c74..2b85912 100644 (file)
--- a/docs/reference/glib/tmpl/messages.sgml
+++ b/docs/reference/glib/tmpl/messages.sgml
@@ -166,15 +166,32 @@ must be combined with the G_LOG_FLAG_FATAL and G_LOG_FLAG_RECURSIVE bit flags.
 Note that since the G_LOG_LEVEL_ERROR log level is always fatal, if you want
 to set a handler for this log level you must combine it with G_LOG_FLAG_FATAL.
 </para>
+<para>
 
 <example>
-<title>Adding a log handler for all warning messages</title>
+<title>Adding a log handler for all warning messages in the default (application) domain</title>
 <programlisting>
   g_log_set_handler (NULL, G_LOG_LEVEL_WARNING | G_LOG_FLAG_FATAL
                      | G_LOG_FLAG_RECURSIVE, my_log_handler, NULL);
 </programlisting>
 </example>
 
+<example>
+<title>Adding a log handler for all critical messages from GTK+</title>
+<programlisting>
+  g_log_set_handler ("Gtk", G_LOG_LEVEL_CRITICAL | G_LOG_FLAG_FATAL
+                     | G_LOG_FLAG_RECURSIVE, my_log_handler, NULL);
+</programlisting>
+</example>
+
+<example>
+<title>Adding a log handler for <emphasis>all</emphasis> messages from GLib</title>
+<programlisting>
+  g_log_set_handler ("GLib", G_LOG_LEVEL_MASK | G_LOG_FLAG_FATAL
+                     | G_LOG_FLAG_RECURSIVE, my_log_handler, NULL);
+</programlisting>
+</example>
+
 @log_domain: the log domain, or %NULL for the default "" application domain.
 @log_levels: the log levels to apply the log handler for. To handle fatal
 and recursive messages as well, combine the log levels with the