D-Bus-examples.md

@@ -96,6 +96,12 @@ i = dbus.Interface(obj, 'org.freedesktop.DBus.Properties')
 i.GetAll('org.freedesktop.ModemManager1.Sms') 
 ```
 
+## Using Applications to Provide Services
+
+GNOME applications run using the `--gapplication-service` command line option will expose the [org.freedesktop.Application](https://standards.freedesktop.org/desktop-entry-spec/desktop-entry-spec-latest.html#dbus) interface on the session bus. This can be accessed to launch the application and request that it open files specified with URIs. The parameters of the API are explained by [this GApplication D-Bus APIs document](https://wiki.gnome.org/Projects/GLib/GApplication/DBusAPI) which refers to a different interface but which seems to overlap with the freedesktop interface.
+
+When the application is run using the `--gapplication-service` option, it waits for a short time in order to receive any pending activation messages via the D-Bus interface, but does not activate itself. If it doesn't receive a message then it exits silently.
+
 ## References
 
 * https://dbus.freedesktop.org/doc/dbus-python/tutorial.html
@@ -105,4 +111,6 @@ i.GetAll('org.freedesktop.ModemManager1.Sms')
 * https://wiki.gnome.org/HowDoI/GDBusPython - uses the `Gio` API from GNOME
 * https://www.freedesktop.org/wiki/Software/systemd/dbus/ - shows use of the `gdbus` tool
 * https://stackoverflow.com/questions/21793826/simple-but-specific-listener-and-sender-python-3-dbus-example
-* https://github.com/stylesuxx/python-dbus-examples - includes a very useful example for showing how to receive signals simply
\ No newline at end of file
+* https://github.com/stylesuxx/python-dbus-examples - includes a very useful example for showing how to receive signals simply
+* https://wiki.gnome.org/HowDoI/DBusApplicationLaunching - C and autotools oriented guide to application launching with D-Bus
+* 
\ No newline at end of file