GApplication: document IS_SERVICE timeout properly

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

View File

@ -1531,9 +1531,12 @@ g_application_open (GApplication *application,
* non-zero then the default main context is iterated until the use count
* falls to zero, at which point 0 is returned.
*
* If the %G_APPLICATION_IS_SERVICE flag is set, then the exiting at
* use count of zero is delayed for a while (ie: the instance stays
* around to provide its <emphasis>service</emphasis> to others).
* If the %G_APPLICATION_IS_SERVICE flag is set, then the service will
* run for as much as 10 seconds with a use count of zero while waiting
* 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
*

View File

@ -1339,8 +1339,9 @@ typedef enum
* GApplicationFlags:
* @G_APPLICATION_FLAGS_NONE: Default
* @G_APPLICATION_IS_SERVICE: Run as a service. In this mode, registration
* fails if the service is already running, and the application will
* stay around for a while when the use count falls to zero.
* fails if the service is already running, and the application
* 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_HANDLES_OPEN: This application handles opening files (in
* the primary instance). Note that this flag only affects the default