diff options
Diffstat (limited to 'gio/src/gio_docs.xml')
-rw-r--r-- | gio/src/gio_docs.xml | 20 |
1 files changed, 18 insertions, 2 deletions
diff --git a/gio/src/gio_docs.xml b/gio/src/gio_docs.xml index 83a43911..1644cc42 100644 --- a/gio/src/gio_docs.xml +++ b/gio/src/gio_docs.xml @@ -185,6 +185,10 @@ The #GAppLaunchContext::launch-failed signal is emitted when a #GAppInfo launch fails. The startup notification id is provided, so that the launcher can cancel the startup notification. +Because a launch operation may involve spawning multiple instances of the +target application, you should expect this signal to be emitted multiple +times, one for each spawned instance. + Since: 2.36 </description> @@ -218,6 +222,10 @@ It allows tracking the progress of the launchee through startup. It is guaranteed that this signal is followed by either a #GAppLaunchContext::launched or #GAppLaunchContext::launch-failed signal. +Because a launch operation may involve spawning multiple instances of the +target application, you should expect this signal to be emitted multiple +times, one for each spawned instance. + Since: 2.72 </description> @@ -241,7 +249,13 @@ Since: 2.72 <signal name="GAppLaunchContext::launched"> <description> The #GAppLaunchContext::launched signal is emitted when a #GAppInfo is successfully -launched. The @platform_data is an GVariant dictionary mapping +launched. + +Because a launch operation may involve spawning multiple instances of the +target application, you should expect this signal to be emitted multiple +times, one time for each spawned instance. + +The @platform_data is an GVariant dictionary mapping strings to variants (ie `a{sv}`), which contains additional, platform-specific data about this launch. On UNIX, at least the `pid` and `startup-notification-id` keys will be present. @@ -9245,7 +9259,9 @@ Since: 2.50 Launches the application. This passes the @uris to the launched application as arguments, using the optional @context to get information about the details of the launcher (like what screen it is on). -On error, @error will be set accordingly. +On error, @error will be set accordingly. If the application only supports +one URI per invocation as part of their command-line, multiple instances +of the application will be spawned. To launch the application without arguments pass a %NULL @uris list. |