doc: foot.ini: desktop-notification: remove 'notification dismissal'

This commit is contained in:
Daniel Eklöf 2024-07-23 16:52:18 +02:00
parent 79832c16e2
commit 511d4817d3
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F

View file

@ -457,7 +457,9 @@ Note: do not set *TERM* here; use the *term* option in the main
Window activation (focusing)
Foot can focus the window when the notification is
"activated". This typically happens when the default action is
'activated'. It can also send an event back to the client
application, notifying it that the notification has been
'activated', This typically happens when the default action is
invoked, and/or when the notification is clicked, but exact
behavior depends on the notification daemon in use, and how it
has been configured.
@ -497,21 +499,6 @@ Note: do not set *TERM* here; use the *term* option in the main
reporting the XDG activation token in any way. This means
window activation will not work by default.
Notification dismissal
The kitty desktop notifications protocol (OSC-99) allows the
terminal application to request an event be sent to it when
the notification has been dismissed (by setting *a=report* in
the notification request).
To be able to send this event, foot needs to know when the
notification is dismissed. This is handled in a very simple
manner; the command signals notification dismissal by
exiting. That is, as soon as the command returns, foot
considers the notification dismissed.
For *notify-send*, this can be achieved with the *--wait*
option.
Default: _notify-send --wait --app-name ${app-id} --icon ${icon} --urgency ${urgency} --action ${action} -- ${title} ${body}_.
*inhibit-when-focused*