From dad02de97011033afe6bf30b89b974208c4ea753 Mon Sep 17 00:00:00 2001 From: Tavmjong Bah Date: Tue, 3 Apr 2018 11:11:12 +0200 Subject: Add new directory for 'actions' with README. --- src/actions/README | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 src/actions/README (limited to 'src') diff --git a/src/actions/README b/src/actions/README new file mode 100644 index 000000000..b6806d8d3 --- /dev/null +++ b/src/actions/README @@ -0,0 +1,26 @@ + +This directory contains Gio::Actions. + +"A GAction (Gio::Action) is a representation of a single +user-interesting action in an application." +(https://wiki.gnome.org/HowDoI/GAction) + +In more layman terms, it provides a uniform interface for calling +functions with an optional single parameter that is not tied to the +GUI. + +Actions provide two operations: + +* activation (which results in calling the function), +* state change (if the action supports a state). + +While actions are defined independent of the GUI (unlike GtkAction), +the can be used by "actionable widgets" (menus, buttons, etc.) by +simply referring to them by name. They can also be remotely activated +by D-Bus and GNotifications. + +To do: + +* Convert 'verbs' to Gio::Actions. +* Update command line to use actions. +* Update GUI to use actions. -- cgit v1.2.3