luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2024-11-10 11:26:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

gmessages: Update advice for G_LOG_DOMAIN

Browse Source 
Suggest defining it for all code — for applications as well as for
libraries. This allows G_MESSAGES_DEBUG=my-app to be used to filter out
all messages from libraries which it uses, for example.

https://bugzilla.gnome.org/show_bug.cgi?id=777956
This commit is contained in:
Philip Withnall 2017-01-30 22:50:00 +00:00 committed by Philip Withnall
parent 8330b09d78
commit 493723b4d9
1 changed files with 11 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
glib/gmessages.c
View File

@ -273,19 +273,27 @@ myInvalidParameterHandler(const wchar_t *expression,
/** /**
* G_LOG_DOMAIN: * G_LOG_DOMAIN:
* *
* Defines the log domain. * Defines the log domain. See [Log Domains](#log-domains).
* *
* Libraries should define this so that any messages * Libraries should define this so that any messages
* which they log can be differentiated from messages from other * which they log can be differentiated from messages from other
* libraries and application code. But be careful not to define * libraries and application code. But be careful not to define
* it in any public header files. * it in any public header files.
* *
* For example, GTK+ uses this in its Makefile.am: * Log domains must be unique, and it is recommended that they are the
* application or library name, optionally followed by a hyphen and a sub-domain
* name. For example, `bloatpad` or `bloatpad-io`.
*
* If undefined, it defaults to the default %NULL (or `""`) log domain; this is
* not advisable, as it cannot be filtered against using the `G_MESSAGES_DEBUG`
* environment variable.
*
* For example, GTK+ uses this in its `Makefile.am`:
* |[ * |[
* AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\" * AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\"
* ]| * ]|
* *
* Applications can choose to leave it as the default %NULL (or "") * Applications can choose to leave it as the default %NULL (or `""`)
* domain. However, defining the domain offers the same advantages as * domain. However, defining the domain offers the same advantages as
* above. * above.
* *