[glib] docs: Clarify relationship of quit() to hold count



commit 7b9503a4f866ce915ad0dfea607f3b734c685e98
Author: Philip Chimento <philip chimento gmail com>
Date:   Wed Sep 24 09:57:52 2014 -0700

    docs: Clarify relationship of quit() to hold count
    
    Calling g_application_quit() ignores the hold count; this patch adds a
    warning to the documentation about other code having a hold on the
    application and expecting it to exist.
    
    https://bugzilla.gnome.org/show_bug.cgi?id=737278

 gio/gapplication.c |    4 ++++
 1 files changed, 4 insertions(+), 0 deletions(-)
---
diff --git a/gio/gapplication.c b/gio/gapplication.c
index 0ee6ca6..5350c87 100644
--- a/gio/gapplication.c
+++ b/gio/gapplication.c
@@ -2624,6 +2624,10 @@ g_application_set_default (GApplication *application)
  * calling only the 'shutdown' function before doing so.
  *
  * The hold count is ignored.
+ * Take care if your code has called g_application_hold() on the application and
+ * is therefore still expecting it to exist.
+ * (Note that you may have called g_application_hold() indirectly, for example
+ * through gtk_application_add_window().)
  *
  * The result of calling g_application_run() again after it returns is
  * unspecified.


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]