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
This commit is contained in:
Philip Chimento 2014-09-24 09:57:52 -07:00 committed by Philip Withnall
parent b8f9c08a09
commit 7b9503a4f8

View File

@ -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.