From f66942549f532295a282993478daafacc8eb79cc Mon Sep 17 00:00:00 2001 From: Hugo Osvaldo Barrera Date: Thu, 30 Mar 2017 14:02:09 -0300 Subject: [PATCH] Document actions and how to interact with them --- docs/dunst.pod | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/docs/dunst.pod b/docs/dunst.pod index 66e0f0c..273ff36 100644 --- a/docs/dunst.pod +++ b/docs/dunst.pod @@ -197,7 +197,7 @@ Don't timeout notifications popped up from history. =item B<-show_indicators> -Show indicators for actions and URLs. +Show indicators for actions and URLs. See ACTIONS below for futher details. =item B<-sort> @@ -264,6 +264,22 @@ The progress value can be set with a hint, too. =back +=head1 ACTIONS + +Dunst allows notifiers (i.e.: programs that send the notifications) to specify +actions. Dunst has support for both displaying indicators for these, and +interacting with these actions. + +If "show_indicators" is true and a notification has an action, an "(A)" will be +prepended to the notification format. Likewise, an "(U)" is preneded to +notifications with URLs. It is possible to interact with notifications that +have actions regardless of this setting, though it may not be obvious which +notifications HAVE actions. + +The "context" keybinding is used to interact with these actions, by showing a +menu of possible actions. This feature requires "dmenu" or a dmenu drop-in +replacement present. + =head1 MISCELLANEOUS Dunst can be paused by sending a notification with a summary of "DUNST_COMMAND_PAUSE"