gmessages: Expand documentation on GLogWriterFunc chaining

As prompted by Marc-Andre Lureau.

Signed-off-by: Philip Withnall <withnall@endlessm.com>

https://bugzilla.gnome.org/show_bug.cgi?id=661926
This commit is contained in:
Philip Withnall
2017-06-14 09:56:13 +01:00
parent ad49479265
commit ac0b0c84f7
2 changed files with 11 additions and 1 deletions

View File

@@ -1586,7 +1586,10 @@ done_query:
* Log a message with structured data. The message will be passed through to
* the log writer set by the application using g_log_set_writer_func(). If the
* message is fatal (i.e. its log level is %G_LOG_LEVEL_ERROR), the program will
* be aborted at the end of this function.
* be aborted at the end of this function. If the log writer returns
* %G_LOG_WRITER_UNHANDLED (failure), no other fallback writers will be tried.
* See the documentation for #GLogWriterFunc for information on chaining
* writers.
*
* The structured data is provided as keyvalue pairs, where keys are UTF-8
* strings, and values are arbitrary pointers — typically pointing to UTF-8