luc14n0/glib
1
0
Fork 0
mirror of https://gitlab.gnome.org/GNOME/glib.git synced 2025-02-04 10:16:17 +01:00
Code Issues Packages Projects Releases Wiki Activity

GApplication: document IS_SERVICE timeout properly

Browse Source 
The documentation was suggesting that using G_APPLICATION_IS_SERVICE
would automatically set an inactivity timeout (ie: app stays around for
a while after the use count drops to zero).

In reality, it only adds an initial 10 second wait for the first
activation message to arrive after which it uses the normal inactivity
timeout mechanism.
This commit is contained in:
Ryan Lortie 2013-02-21 14:58:32 +00:00
parent ce0ff7c9da
commit 5bbca5fa0c
2 changed files with 9 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
gio/gapplication.c
View File

@ -1531,9 +1531,12 @@ g_application_open (GApplication *application,
* non-zero then the default main context is iterated until the use count * non-zero then the default main context is iterated until the use count
* falls to zero, at which point 0 is returned. * falls to zero, at which point 0 is returned.
* *
* If the %G_APPLICATION_IS_SERVICE flag is set, then the exiting at * If the %G_APPLICATION_IS_SERVICE flag is set, then the service will
* use count of zero is delayed for a while (ie: the instance stays * run for as much as 10 seconds with a use count of zero while waiting
* around to provide its <emphasis>service</emphasis> to others). * for the message that caused the activation to arrive. After that,
* if the use count falls to zero the application will exit immediately,
* except in the case that g_application_set_inactivity_timeout() is in
* use.
* *
* Returns: the exit status * Returns: the exit status
* *

5
gio/gioenums.h
View File

@ -1339,8 +1339,9 @@ typedef enum
* GApplicationFlags: * GApplicationFlags:
* @G_APPLICATION_FLAGS_NONE: Default * @G_APPLICATION_FLAGS_NONE: Default
* @G_APPLICATION_IS_SERVICE: Run as a service. In this mode, registration * @G_APPLICATION_IS_SERVICE: Run as a service. In this mode, registration
* fails if the service is already running, and the application will * fails if the service is already running, and the application
* stay around for a while when the use count falls to zero. * will initially wait up to 10 seconds for an initial activation
* message to arrive.
* @G_APPLICATION_IS_LAUNCHER: Don't try to become the primary instance. * @G_APPLICATION_IS_LAUNCHER: Don't try to become the primary instance.
* @G_APPLICATION_HANDLES_OPEN: This application handles opening files (in * @G_APPLICATION_HANDLES_OPEN: This application handles opening files (in
* the primary instance). Note that this flag only affects the default * the primary instance). Note that this flag only affects the default