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

Merge branch 'Docs' into 'master'

Browse Source 
docs: Improved documentation of GNotification

Closes #2405

See merge request GNOME/glib!2102
This commit is contained in:
Philip Withnall 2021-05-17 10:30:55 +00:00
commit 62571c71b5
1 changed files with 23 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
gio/gnotification.c
View File

@ -43,6 +43,29 @@
* not running, applications using #GNotification should be able to be * not running, applications using #GNotification should be able to be
* started as a D-Bus service, using #GApplication. * started as a D-Bus service, using #GApplication.
* *
* In order for #GNotification to work, the application must have installed
* a `.desktop` file. For example:
* |[
* [Desktop Entry]
* Name=Test Application
* Comment=Description of what Test Application does
* Exec=gnome-test-application
* Icon=org.gnome.TestApplication
* Terminal=false
* Type=Application
* Categories=GNOME;GTK;TestApplication Category;
* StartupNotify=true
* DBusActivatable=true
* X-GNOME-UsesNotifications=true
* ]|
*
* The `X-GNOME-UsesNotifications` key indicates to GNOME Control Center
* that this application uses notifications, so it can be listed in the
* Control Center’s ‘Notifications’ panel.
*
* The `.desktop` file must be named as `org.gnome.TestApplication.desktop`,
* where `org.gnome.TestApplication` is the ID passed to g_application_new().
*
* User interaction with a notification (either the default action, or * User interaction with a notification (either the default action, or
* buttons) must be associated with actions on the application (ie: * buttons) must be associated with actions on the application (ie:
* "app." actions). It is not possible to route user interaction * "app." actions). It is not possible to route user interaction