[glib] docs: Encourage applications to define G_LOG_DOMAIN
- From: Debarshi Ray <debarshir src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [glib] docs: Encourage applications to define G_LOG_DOMAIN
- Date: Thu, 20 Jul 2017 17:47:05 +0000 (UTC)
commit 8962736ba9deb8f6a6b143fce1b6fd692ffaaa21
Author: Debarshi Ray <debarshir gnome org>
Date: Thu Jul 20 18:57:01 2017 +0200
docs: Encourage applications to define G_LOG_DOMAIN
https://bugzilla.gnome.org/show_bug.cgi?id=785130
glib/gmessages.c | 9 +++++++--
1 files changed, 7 insertions(+), 2 deletions(-)
---
diff --git a/glib/gmessages.c b/glib/gmessages.c
index cac882f..5979f64 100644
--- a/glib/gmessages.c
+++ b/glib/gmessages.c
@@ -275,8 +275,7 @@ myInvalidParameterHandler(const wchar_t *expression,
*
* Defines the log domain.
*
- * For applications, this is typically left as the default %NULL
- * (or "") domain. 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
* libraries and application code. But be careful not to define
* it in any public header files.
@@ -285,6 +284,12 @@ myInvalidParameterHandler(const wchar_t *expression,
* |[
* AM_CPPFLAGS = -DG_LOG_DOMAIN=\"Gtk\"
* ]|
+ *
+ * Applications can choose to leave it as the default %NULL (or "")
+ * domain. However, defining the domain offers the same advantages as
+ * above.
+ *
+
*/
/**
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]