From 8962736ba9deb8f6a6b143fce1b6fd692ffaaa21 Mon Sep 17 00:00:00 2001
From: Debarshi Ray <debarshir@gnome.org>
Date: Thu, 20 Jul 2017 18:57:01 +0200
Subject: [PATCH] docs: Encourage applications to define G_LOG_DOMAIN

https://bugzilla.gnome.org/show_bug.cgi?id=785130
---
 glib/gmessages.c | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/glib/gmessages.c b/glib/gmessages.c
index cac882f6b..5979f6429 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.
+ *
+
  */
 
 /**