[glib] docs: Encourage applications to define G_LOG_DOMAIN



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]